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OS/VS VSAM FOR SYSTEM PROGRAMMERS 


Duration: Four days 


Audience: Personnel performing the functions of VSAM systen 
programming. implementation and design. 


Recommended Background: Knowledge of IBM direct access devices and 
VSAM coding. Attendees should have a knowledge of the various 
data set formats supported by VSAM and how they are defined. They 
should also understand the various methods of accessing data and 
have a familiarity with the basic functions of VSAM Access Method 
Services. This knowledge may have been obtained by completion of 
the course DASD Data Management (H3720) of VSAM Coding 
(A3750) or VSAM ISP's or equivalent experience. 


Prerequisite Test: Yes 


Coerse Abstract: This course is intended to build upon the students 
knowledge of VSAM to a level at which they, as system programmers 
can efficiently install and implement VSAM. The student should 
become familiar with the VSAM catalog structure and use. and be 
able to define and maintain the Master and User catalogs. In addition 


[A3754] 
Tuition: $565 


Course Objectives: Upon completion of this course the student should be 


able to: 


|. Create and maintain Master and User Catalogs. 

2. Calculate space required for Catalogs and Data Sets. 

3. Cite catalog and data set recovery methods and techniques. 

4. State the relationships between define options and their effect on 
optimization including the impact of control interval and control 
area sizes. 

5. Interpet an Access Method Services print listing of a VSAM 
catalog. 

6. Identify those factors and standards necessary to successfully 
install and use VSAM. 

7. Utilize the security and integrity features of VSAM. 

8. State the requirements necessary to properly utilize the sharing 
capabilities of VSAM between. Jobs. Systems. and Subtasks. 

9. State the differences of VSAM in MVS. 

10. Define and use Alternate Index capability. 


to defining a data set. the student should become familiar with 
defining Alternate Indexes and Paths and how to access the data using 
Alternate Indexes. The student should become knowledgeable in 
catalog and data set recovery. including the use of the catalog 
recovery area. The student should be able to fully utilize VSAM 
Access Method Services and be able to select those VSAM options 
and processing techniques which will provide for proper utilization of 
VSAM. They will be given a functional overview of VSAM control 
blocks and be able to design a VSAM data set for better uthization of 
space, portability and performance. How to protect catalogs and data 
sets will also be covered. Throughout the course suggested standards 
for using VSAM will be presented to assist easier implementation and 


Course Topics: 


VSAM Catalogs 

Recovering VSAM Catalogs and Data Sets 

VSAM Data Set Optimization Considerations 

Security and Integrity 

Special Processing 

VSAM Sharing 

Access Methods Services - throughout the course where appropriate. 
MVS Considerations 

Alternate Indexes 


Competer Exercises: To provide the student with experience in: (1) 


use of VSAM. This course ts for those using OS/MVS OS/VS§2 
Release |. and OS/VSI 


Defining and accessing » duta set with Alternate Indexes and Paths. 
(2) recovery of a data set, using Acess Method Services. 


H.1.1 
VSAM OBJECTIVES 
IMPROVED PERFORMANCE 
SINGLE ACCESS METHOD FOR PROCESSING MODES 
CROSS SYSTEM COMPATIBILITY (DOS-OS) 
NEW DATA ORGANIZATION 
SIMPLE TO USE JCL 
ALL DATA SETS MUST BE CATALOGED 
IMPROVED RELIABILITY 
VSAM SUPPORTED BY VS PROGRAM PRODUCTS (DOS/OS) 
CONVERSION WITH ISAM INTERFACE 
H.1.2 


VSAM FEATURES AND BENEFITS 


DATA SECURITY 
DATA INTEGRITY 
PHYSICAL RECORD MOVEMENT MINIMIZED 
SOFTWARE EOF 
DEVICE INDEPENDENCE WITH CI/CA TYPE OF DATA STRUCTURE 
DECREASED FILE REORGANIZATION 
ERROR RETURN CODES INSTEAD OF ABENDS 
TYPES OF ACCESS 
KEY 
ADDRESS — (RBA) 
CONTROL INTERVAL — CI (RBA) 
RELATIVE RECORD NUMBER 
DATA PORTABILITY BETWEEN SYSTEMS 
OS/VS — DOS/VS 


H.1.3 


ae ee 


REVIEW OF VSAM DATA ORGANIZATION 


THREE TYPES OF DATA SETS 
® KSDS KEY SEQUENTIAL DATA SET 


2 SEPARATE VSAM COMPONENTS DATA AND 
INDEX ACCESS BY KEY OR ADDRESS 


DISTRIBUTED FREE SPACE Cl AND CA 
RECORDS ARE PHYSICALLY MOVED AND DELETED 
@® SDS ENTRY SEQUENCE DATA SET 
DATA COMPONENT ONLY NO KEYS OR INDEX 
ACCESS BY ADDRESS 
ADDITIONS ADDED TO END OF THE DATA SET 
RECORDS ARE NOT MOVED OR DELETED 
@® RELATIVE RECORD DATA SET 
FIXED LENGTH RECORDS ONLY 
VIEWED AS A STRING OF SLOTS 
ACCESS IS BY RELATIVE RECORD NUMBER 
ADDITIONS ARE TO EMPTY SLOTS 
DELETIONS MARK A SLOT AS EMPTY 
RECORDS ARE NOT MOVED 
NO FREE SPACE 
EACH Cl CONTAINS THE SAME NUMBER OF SLOTS H.1.4 


Su ay ' nae : 
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ee “Sy 


c Control Interval 


Ug “YY R R |R 
Format | LR, jLRo LR, Free Space 2 7 e 
=e ee Gy n 24°) 


e Unit of transmission between virtual storage and DASD. 


NORM 


e Length is system-determined. 
User can request a specific length. 


Y ; 
wate] |p A 


Example 


ee ad 


C 


CONTROL AREA SIZE 


IF ALLOCATION IS BY: 


CY: TRACKS PER CYL 
TRACKS: MIN (PRIMARY,SECONDARY) 
RECORDS: MIN (PRIMARY,SECONDARY) 


= H.1.6 


@- apie 8 : 
: CONTROL INTERVAL SIZE 
© DATA COMPONENT 
UP TO 8K — MULTIPLE OF 512 - 
OVER 8K  — MULTIPLE OF 2048 
MAXIMUM — 32768 
° INDEX COMPONENT 
512, 1024, 2048, 4096 (3330 AND 3340 ONLY) 
pee ! ; 
( if ( ( ye % j 
ad 
H.1.7 
CI/PHYSICAL BLOCK RELATIONSHIPS ee 


e PHYSICAL BLOCK SIZES VSAM USES: 
512, 1024, 2048, 4096 


4096 IS INVALID FOR 2314 


CONTROL INTERVAL PHYSICAL BLOCK NUMBER OF 
as SIZE BLOCKS/CI 


A SOA aa SN 
3072 


j 3584 51 PID 
4096 
4096 
2048 
me 4) 
3 


Hy 


PHYSICAL BLOCK — DASD CAPACITY 


RECDS RECDS 
oe aie TRK eae TRK 


which is why 
VSAM doesn’t 
use it! 


Tea 


RECDS 
ee R TRK 


3330 COMP. 


bat 


H.1.9 


Index Structure 


Index 


nose case rr 10080 | Fre 4 
Area 
iat = [ 10300] 10333 | Fre 


Control 


Free Space yy 
| 10334 | 13000 | 13500] 14000 | Fre YY 
[| loz | 14023 | taoza | 14028 | Free Y 
Control 
reo 


Free Space Y 


H.1.10 


INDEX RECORD FORMAT 


HEADER FREE FREE 
PTR* | PTR* 


"EXISTS ONLY IN SEQUENCE SET RECORDS 


ZO-AMQMMN 
<DiAZwzMm 
<DiAZwmM 
<DiAwzmMm 


<DiAZwzMmM 
Zzo7AdamMMN 


H.1.11 


INDEX ENTRY 

Total Length 
of 3 Fields 
is in Header 

(V) 

Key 

Pointer 
| a Se eee * 
—, 


H.1.12 


) 


3 
# OF INDEX ENTRIES PER CI SIZE 
58 512 
120 1024 
248 2048 
502 4096 
H.1.13 


VSAM FEATURES AND BENEFITS 
ACCESS METHOD SERVICES 


CHARACTERISTICS 
DATA SET UTILITY 
INTERFACE TO VSAM AND THE CATALOG 


INVOKED BY 
JCL 
TSO TERMINAL 


H 1.14 


C ACCESS METHOD SERVICES 
The following is a coding example of invoking Access Method Services as 
within the program. This example is a LISTCAT ALL command. 
//STEP1 EXEC ASMFCLG 
//ASMH.SYSIN DD * 
CSECT START 
SAVE (14,12) 
BALR 12,0 
USING *,12 
LA 11,SAVE 
ST 13,SAVE+4 
ST 11,8 (13) 
LR 13,11 — 
LINK EP=IDCAMS, PARAM=(QETION, DDNANE, PAGE, IOLIST) , ¥L=1 
L 13,SAVE+4 
RETURN (14,12) ,RC=0 
INROOT SAVE (14, 12) I/O ROUTINE 
BALR 10,0 
USING *,10 
st 13,SVAE2¢4 
LA 11,SAVE2 
ST 11,8 (13) 
LR 13,11 
L 3,4%(1) REG3 - PTR I/O FLAGS 
SR ° 
Ic 4,0¢3) REG4 - CODE INDICATING OPERATION sae 
Cc QY,=F"'s* TEST CODE 8 - GET 
BHE OPENCLOS 
St ROP END 
MVI SW+1,X°FO!# SET SWITCH FOR SECOND GET 
L 6,8 (1) REG6 - PTR I/O INFORMATION 
MVC 0 (4, 6) , =A (COMMAND) PTR RECORD TO I/O INFO 
MYC 4(4,6) ,=F* 80° RECORD LENGTH TC I/O INFO 
L 13,SAVE2+¢4 
RETURN (14,12) ,RC=0 
END L 13,SAVF2+¢4 SECOND TIME - END OF DATA 
RETURN (14,12) ,RC=4 
OPENCLOS L 13,SAVE2+4 RETURN IF OPEN/CLOSE 
RETURN (14,12) ,RC=0 . 
SAVE DC 18F°O* 
SVAE2 DC 18F*O! 
OPTICH DC H*Q* 
DONANE DC H*0* 
PAGE DC H*O* 
IOLIST DC Fe 1" 
DC A (DDCARD) 
DC A (IN ROOT) 
CC F*O' 
COPMAND DC CLEO"LISTC ALL* 
DDCARD DC CL10*DDSYSIN* 
END 
C //GO.SYSPRINT DD SYSOUT=A ia 


//GO.~STEPCAT DD DSN=CSVS.VSAMUCAT,DISP=SHR 
//GO.SYSUDUGME DD SYSOUT=A 


H 1.15 


ALTERNATE INDEXES 


c 


@ ABILITY TO ACCESS A KSDS BY A KEY OTHER THAN THE PRIME KEY 
EXAMPLE: PAYROLL FILE BY NAME, EMPLOYEE SERIAL NUMBER, OR 
DEPARTMENT NUMBER 


ABILITY TO ACCESS AN ESDS BY KEY 


ABILITY TO INDEX ON A NON-UNIQUE KEY FIELD 


ABILITY TO HAVE MULTIPLE PATHS TO A DATA SET 


H.2.1 
tg 
| 3235 livewron] | 3247 [Avams I kinney| prity ep 
| | ea ALTERNATE INDEX 
| a“ DATA RECORDS 
| 4711 | SIEGEL | PRICE pARNOLD LEE 
Yo 
WRIGHI PRICE KINNEY PRIME INDEX 
Q? an 00 
a” 
| | D dhee | Sy 
aDAmMsw | | 3247 | ARNOLD, 4711 KINNEY ) 4247 - 
| | | mes PRIME 
a DATA 
| pETITYO | 3 Lo] opie | arid | ee BASE 
even, | 3235 | t oe to , Ze 
” 
| | | 
AIN1 wright | | yea , 
H.2.2 


| SIEGEL | , 


ALTERNATE INDEX RECORD FORMAT 


—,, 
FLAG POINTER NUNIBER (OF LENGTH OF | | | } 
| BYTE LENGTH POINTERS ALTERNATE See POINTER } fo oa POINTER N 
«Vo bytes 12 byte | KEY KEY 
(T hytet 
| SAN 
O RBA ponters ; | . oS sg 
‘base clusier «s ESDS! - i 
f x \ Jj 
1+ prime key pointers / i aa 
ibase cluster 1s KSDS! > 
- ( ' ae: 
i — 
H.2.3 
Oy 
PATH CONCEPT 
cr @ PATH IS VEHICLE FOR 
ACCESS VIA ALTERNATE KEY 
ALTERNATE INDEX 1 ALTERNATE INDEX 2 @ PATH CONSISTS OF BASE 
FILE-ID=AIX1 FILE-ID=AIX2 CLUSTER AND, OPTIONALLY, 
AN ALTERNATE INDEX 
@® MULTIPLE PATHS FOR SAME 
ALTERNATE INDEX OR 
FOR BASE CLUSTER 
PATH PATH : 
FILE-ID FILE-ID 
AIX1 AIX2 
RELEASE 1 CLUSTER 
data 
FILE-ID=BASE 
sarttan 
H.2.4 


THE UPGRADE SET 


— 


A 
LTTE ; 


Lehn oo Ral ie ee POM cd 
Gitre: 
YZ 


egies 


\\ 


ALTERNATE INDEX 1 ALTERNATE INDEX 2 


ANY 


ALTERNATE INDEX 3 


BASE 
CLUSTER 


UPGRADE SET 


ALTERNATE INDEX 4 


H.2.5 


AUTOMATIC UPGRADE 


FOR MEMBERS OF UPGRADE SET 

IF BASE CLUSTER OPENED DIRECTLY OR VIA UPDATE PATH 

NEW POINTERS ARE ADDED TO END OF POINTER SET OF ALTERNATE 
INDEX RECORD (ARRIVAL-TIME ORDER) 

ALTERNATE KEYS EXCEPT THE KEY OF REFERENCE MAY BE CHANGED 
UPDATES OR INSERTS FAIL JF THEY PRODUCE A NON-UNIQUE KEY FOR A 
UNIQUEKEY MEMBER OF THE UPGRADE SET 


H.2.6 


STEPS FOR LOADING AN ALTERNATE INDEX 


DEFINE THE ALTERNATE INDEX 


EXTRACT ALTERNATE KEYS & POINTERS 


ORDER KEYS & POINTERS BY ALTERNATE KEY SEQUENCE 


BUILD ALTERNATE INDEX RECORDS 


BUILD ALTERNATE INDEX AS A KSDS 


H.2,7 


DEFINING AN ALTERNATE INDEX 
ACCESS METHOD SERVICES 
DEFINE ALTERNATEINDEX 
(RELATE (entryname [/password] ) 
[UPGRADE | NOUPGRADE] 


[UNIQUEKEY | NONUNIQUEKEY] SAME AS FOR KSDS CLUSTER LEVEL, 
@ BUT YOU CANNOT SPECIFY 
© <—_____________—— INDEXED, { SPANNEDINONSPANNED } . 
e KEYS APPLIES TO ALTERNATE KEY. 

) 

[DATA 

( [UNIQUEKEY | NONUNIQUEKEY] 

@ SAME AS FOR KSDS DATA LEVEL, 


© cg BUT YOU CANNOT SPECIFY { SPANNED| 
e NONSPANNED } . KEYS APPLIES TO 
ALTERNATE KEY. 


| 
[INDEX 


Og ————— SAME AS FOR KSDS INDEX LEVEL 


H.2.8 


DEFINE ALTERNATE INDEX 


DEFINE ALTERNATEINDEX (NAME (DEPT.NUMBER.AIX.PAYROLL) - 

RELATE (PAYROLL/MASTERPW) — 
VOLUMES (AIX001 AIX002) — 
UPGRADE) —- 

DATA (NAME (DEPT.NUMBER.DATA) — 
CYLINDERS (5 5) — 
RECORDSIZE (200 4046) — 
KEYS (7 65) — 
NONUNIQUEKEY) — 

INDEX (NAME (DEPT.NUMBER.INDEX) — 
IMBED — 
CYLINDERS (2 1)) 


H.2.9 


DEFINING A PATH 


ACCESS METHOD SERVICES 


DEFINE PATH (NAME (name) 
PATHENTRY (entryname [/password] ) 
[MODEL (entryname[/password] 
[catname[/password] [dname] ] )] 
[FILE (dname)] 
[UPDATE | NOUPDATE] 
[protection parameters] 


[CATALOG (catname[/password] [dname] )] 


H.2.10 


DEFINE PATH 


ve 


DEFINE PATH (NAME (DEPT.NUMBER.PATH.PAYROLL) — 
PATHENTRY (DEPT.NUMBER.AIX.PAYROLL) — 


UPDATE) 


H.2.11 


LOADING ALTERNATE INDEXES 


ACCESS METHOD SERVICES 
BLDINDEX INFILE (dname_ [/password] ) 
OUTFILE (dname_ [/password] ...) 
[EXTERNALSORT |! INTERNALSORT] 
[WORKFILES (dname1 dname2)] 
[CATALOG (catname_ [/password] }] 


DEFAULT WORKFILES: IDCUT1 , IDCUT2 


( H.2.12 


BLDINDEX 


BLDINDEX 


INFILE (base cluster name/master password) 


OUTFILE 


(alternate index name) - 


WORKFILES (sortwrkl sortwrk2) 


A aed 


PROCESSING AN ALTERNATE INDEX AS A KSDS 


ween e ewe wee ewe ew eee eee!’ H- ew eee wee ee eke ew BkzxWw ew e- ewe kee ee ew Be ew ee ee eB eB eee eee ee ee ee eB ee Be 


ACBe 


//DD2 


OPEN 


ACB 


ACB 


DD 


ACBI 


DDNAME=DD!1 


DSNAME = alternate index naime, 


DDNAMEF: 11) 2, MACRE (AIX Ot 


DSNAME = path name, DISP = SHR 


DISP = SHR 


[eles 


H.2.13 
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H.2.14 


PROCESSING ON A PATH LEVEL 


anew ee = we ee ew ew ee ee BF he se Fe ee ee EK PF Fe |= —w eP— we Ee BK we PF Fe | K— BH ee eee EO EE Oe ES OE eS ee ee eel 


OPEN ACBI1 
ACB1 ACB DDNAME=DD1, MACRF=OUT 
DD1 DD DSN= path name, DISP=SHR 


H.2.15 


gee ne 
ACCESSING THROUGH A PATH 


IF PATHENTRY IS ALTERNATE INDEX THEN 
@® KEYED PROCESSING AS FOR KSDS 
@ ALTERNATE KEY ASSOCIATED WITH PATHENTRY 
AIX IS KEY OF REFERENCE 
@ HOWEVER, 
C KEY OF REFERENCE AND PRIME KEY 
CANNOT BE CHANGED 
Q LIMITATIONS IMPOSED BY BASE CLUSTER 
APPLY. 
NO ERASE IF BASE CLUSTER AN ESDS, 
NO UPDATE WITH LENGTH CHANGE IF 
BASE CLUSTER AN ESDS, 
INSERTS GO TO END OF ESDS. 
IF PATHENTRY IS BASE CLUSTER THEN 
@ SAME AS FOR BASE CLUSTER 


H.2.16 


cere er 


HANDLING OF NON-UNIQUE KEYS 


i ! 
ALTERNATE INDEX E 3247 AADAMSH PETTY [KINNEY 


RECORD 
Pee 


| i] 
iPRICEB IKINNEY 
t 


I t i 1 I — 

A 1 4 | Fa m= 

ADAMS | | 3247 ARNOLD , oy KINNEY 1 132477 a 

BASE CLUSTER eee 
DATA COMPONENT ] aaaz 
NEWTON | L 305A PETTY | 3247 PRICED si! WV we | 

v ig a 


POINT positions to first “‘non-unique” of alternate index record (ADAMS#) 


e GET skip-sequential or direct retrieves first ‘‘non-unique’’ as indicated in 
alternate index record (ADAMS#) 


e GET sequential retrieves ‘“‘non-uniques” in order indicated in alternate 
index record (ADAMSB, PETTYG, KINNEY) 


H.2.17 


ALTERNATE INDEX 
RESTRICTIONS 


@ NO ALTERNATE INDEXES FOR RELATIVE RECORD DATA SETS —‘*- 
@ FOR SPANNED RECORDS, ALL KEYS MUST BE WITHIN FIRST SEGMENT 
@ LENGTH OF ALTERNATE KEYS MUST NOT EXCEED 255 -~- 
—+ @ BASE CLUSTER MUST NOT BE EMPTY FOR BLDINDEX 
\@ UPGRADE DONE ONLY FOR NON-EMPTY ALTERNATE INDEXES 


SUNS, eae CARAT 62 at ee ark 


H.2.18 


Cc 


LOCATING MASTER CATALOG 


VS1 SYSCTLG VS2 SYS1.NUCLEUS 
AMASTCAT CVOL POINTER SYSCATLG RECORD 
4 (VS2) 
Fi DSCB STARTS 2999999 OR 
6 (VS1) 


H.3.1 


VSAM INTEGRITY 


F4 DSCB - OWNERSHIP BIT FOR VOLUME OFFSET x’‘54 
F1 DSCB — OS/VS PROTECT BITS ALWAYS ON x‘5D’ 


H.3.2 


VOLUME CONTAINING A VSAM CATALOG 


fd OSCR 


eal 


9999994 YWSAMDS 


fo C Aetna 


VSAM 
DATS SPACE 


/ a 


\ LOW KEY RANGE VSAM CATALOG 


INDEX 
_ HIGH KEY RANGE _- 
H.3.3 
VSAM CATALOG 
INDEX DATA sts 
RELATIONSHIPS ee 
ee _ 
we 7 - 
neat ce 
2 Ae INIE x 
ag he D. SET 
[xyz 0110000 
KEY tile — - 
= >) 
igh? | LOW KEY RANGE 
(Cl ENTRIES} 
f afi | anon] ]xye | 
| : : ALA 
tear amas 1 | Maem en eae _= 
ie i een Dob 
\ 7 ' 
x3 as. 
FO | eee x 
RANGI 
(TRUE NAME oe) mee 
ENTRIES) a ae 
ere H.3.4 


eee ee A oe ee ee ee eee 


\C 


Self-Defining Catalog Records 


e Located by Pre—Defined Physical Location 
@ Formats Same as Object Definition Records 
e Record Contents 


CI@— Data Portion Descriptor 

Cli — Index Portion Descriptor 

Cl2— Cluster Descriptor 

Cl3— Catalog Control Record — Cl Allocation Data 
Cl4— Extension of Cl 1 — High Level Index Extents 
Cl5— ~~ Extension of Cl @ — Low Address Data Extents 
Cl6— Extension of Cl 1 — Low Address Sequence Set 
Cl7— Extension of Cl @ — High Address Data Extents 
ClI8— Extension of Cl 1 — High Address Sequence Set 
CI9— This Volume Space Allocation Descriptor 
CiIA—_— Extension of Cl 9 — This Volume’s Bit Map 
Cip-— Extension of Cl 9 — As Many as Required 


H 3.5 
LOW KEY RANGE RECORD FORMAT 
aera FIXED INFORMATION 
DEPEND ON RECORD TYPE 
CRA INFO 
0 1 4 43044 45 46 47 48 40 
Cc 
0 
HORIZ U |FIELDO] FIELD FIELD FIELDS 
PTR nw |PTRS PTRS PTRS 
T te 
1 
ail Peat VERTICAL 
POINTER en 
00 OIsP |CODE|SEQ= Cl= CODE 
o 1 2 3 4 Oo 2 3 
CODES 1 AMDSB 4 TRACK ALLOCATION 
2 ~ ASSOCIATION 6 DATA SPACE {tNFO 
3 - VOLUME INFO 8B —- DATA SET DIRECTORY er 


4 - PASSWORD 


CATALOG STORAGE ESTIMATE WORKSHEET 


NUMBER OF ENTRIES FOR CATALOG 


NUMBER OF ENTRIES REQUIRED FOR LOW KEY 
RANGE (SEE TABLE) 


O+® 
NUMBER OF CIS FOR HIGH KEY RANGE 


@ 


‘10 (ROUND HIGH) 


TOTAL 


TOTAL NUMBER OF CIS REQUIRED 

QO: @ 
NUMBER OF TRACKS REQUIRED FOR DATA 
(ROUND HIGH) 6) 


NO. OF Cls/TRACK* 


"11 FOR 2314, 20 FOR 3330, 12 FOR 3340, 27 FOR 3350 


NUMBER OF TRACKS FOR IMBED SEQUENCE SET 
(ROUND HIGH) © 


Nn" 


“"4 FOR 2314, 2 FOR 3330, 4 FOR 3340, 2 FOR 3350 


TOTAL NUMBER OF TRACKS FOR DATA AND 
SEQUENCE SET. 


©: @ 


ROUND UP TO MULTIPLE OF CA SIZE n 


n IS 5 FOR 2314, 3 FOR 3330, 5 FOR 3340, 3 FOR 3350 


NUMBER OF TRACKS FOR INDEX SET 


TOTAL NUMBER OF TRACKS FOR 


DATA AND INDEX SET (9) | 


2314 | 3330 | 3340 | 3350 


G2 
on 
GJ 


RNR a ae ~ = 


( CATALOG STORAGE 


—_ LINE 2 OF WORKSHEET 
NUMBER OF ENTRIES REQUIRED FOR LOW KEY RANGE: 


NUMBER OF 
KSDS X 3 = 
ESDS X2 = 
RRDS X 2 = 
PATHS X 1 = 
AIX X3= 
UPGRADE X 1 = 
NON-VSAM X 1 = 
VOL X (3+n)* = 


a 


TOTAL NUMBER OF ENTRIES = 
(LINE 2) 


"n=0 FOR 2314/2319 
n=1 FOR 3330/3340 
n=3 FOR 3350/3330-11 


€ H.3.8 


CATALOG RECOVERY 


@ ABILITY TO DUPLICATE CATALOG INFORMATION AT DECENTRALIZED 
PLACES 


®@ A SET OF ACCESS METHOD SERVICES COMMANDS EASING THE 
RECOVERY FROM THE LOSS OF CATALOG INFORMATION 


Cc H.3.9 


RECOVERABLE CATALOGS 


CA EA 
TALOG RECOVERY AR 


a ee 
ENTRY CATALOG 


ENTRY emg 


j ENTRY \ Nee 


REA 


CATALOG RECOVERY 


H.3.10 
VOLUME CRA WHICH WILL CONTAIN THE 
DUPLICATE CATALOG RECORDS 
ee INDEX 7 CLUSTER \ MASTER CATALOG USER CATALOG 
ener, VOLUME bom vom OWNING NONE MASTER CATALOG 
OF BASE CLUSTER VOLUME OF SPACE VOLUME 
BASE CLUSTER 
Ken -U SAvt | 
rt pum gs! KSDS ESDS RRDS 
. 8 a FIRST INDEX FIRST DATA FIRST DATA 
Re Se VOLUME VOLUME VOLUME 
4.3.11 


¢ j CATALOG RECOVERY AREA (CRA) 


DUPLICATED VOLUME RECORD 
@ SPACE USAGE MAP 
® DATA SPACE DESCRIPTION 
@ DATA SET DIRECTORY 


DUPLICATED CATALOG RECORDS FOR 
OBJECTS FOR WHICH THIS VOLUME 
IS THE RECOVERY VOLUME 


ESTABLISHING A CATALOG RECOVERY AREA 


e THE CATALOG RECOVERY AREA FOR A VOLUME IS 
ESTABLISHED AT THE TIME THE VOLUME ENTRY FOR 
THE VOLUME IS CREATED, I.E., WHEN THE VOLUME 
APPEARS FOR THE FIRST TIME IN THE VOLUMES OR 
ADDVOLUMES LIST OF AN ACCESS METHOD SERVICES 


COMMAND 


e ONE CYLINDER OF THE FIRST SPACE ALLOCATION FOR 
A VOLUME IS SET ASIDE FOR THE CATALOG RECOVERY 


AREA 
ee) €; Ge t é e L j al f 
A) Cee ah PDAs ; if ee, ts Crete (e oo an 
. f ; a 4 "S on go 
[ ) 


wee pe WS a yee . ae 
HH 313 


MOUNTING REQUIREMENTS WITH RECOVERABLE CATALOGS 


ACTION 


DEFINE 


ALTER 


DELETE 


BLDINDEX, 
EXPORT, 


IMPORT, PRINT 
REPRO, VERIFY 


LISTCAT 
VSAM 
PROGRAM 


VOLUME MOUNT REQUIREMENTS 


ALL VOLUMES OF AN EVENTUAL VOLUMES 


LIST, RECOVERY VOLUME OF OBJECT 
BEING DEFINED 


ALL VOLUMES OF EVENTUAL ADDVOLUMES 


OR REMOVEVOLUMES LISTS, RECOVERY 
VOLUME OF OBJECT BEING ALTERED 
ALL VOLUMES OF OBJECT BEING DELETED, 


RECOVERY VOLUME OF OBJECT BEING 
DELETED 


ALL VOLUMES REQUIRED FOR NON- 


RECOVERABLE CATALOG, RECOVERY 
VOLUMES OF OBJECTS BEING PROCESSED 


SAME AS FOR NON-RECOVERABLE CATALOG 
ALL VOLUMES REQUIRED FOR NON- 


RECOVERABLE CATALOG, RECOVERY 
VOLUMES OF OBJECTS BEING PROCESSED 


Catalog Interfaces 


VSAM 
AMS OP|CL IT EOV 


Error 


Messages 


“Detine™ 
“Alter” 

“Delete” 
“List 


OS/VS 
Scheduler 
“Locate” 


OS/VS SVC 26 
Catalog Management 


R15 Error Code 


SVC 32 


DADSM 


SVC 32 


VSAM 
Catalog 
Management 


Extend 


Scratch 


Rename 


Cavsiog 


H.3.14 


H 3.15 
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FOUR LEVELS OF PROTECTION 


MASTER LEVEL 
CONTROL LEVEL 
UPDATE LEVEL 


READ LEVEL 


ENTRY HIERARCHY 


CLUSTER — HIGHEST LEVEL 


DATA/INDEX — SAME LEVEL 


ONLY READ LEVEL PASSWORD SPECIFIED 


READPW(ALLOW)}) 


RESULTS IN: 
MASTER PASSWORD ALLOW 
CONTROL PASSWORD ALLOW 
UPDATE PASSWORD ALLOW 
READ PASSWORD ALLOW 


READ AND CONTROL PASSWORD SPECIFIED 


READPW(ALLOW) 
CONTROLPW(ALLOWIT) 


RESULTS: 
MASTER PASSWORD ALLOWIT 
CONTROL PASSWORD ALLOWIT 
UPDATE PASSWORD not specified 


READ PASSWORD ALLOW 


11.4.4 


C 


AUTHORIZATION PARAMETER 
AUTHORIZATION (ENTRYPOINT STRING) 


ENTRYPOINT IS THE ENTRY POINT OF YOUR ROUTINE ON 
SYS1.LINKLIB. STRING IS YOUR OWN SECURITY INFORMA- 


TION UP TO 256 BYTES 


ABBR. AUTH (ENTRYPOINT STRING) 


H.4.5 


EEE Te a pete en een en nner 


PASSWORD PROTECTION EXAMPLE 1 


CATALOG PROTECTED AT THE MASTER LEVEL 
DEFINE CLUSTER (NAME(FILE1) 
MRPW(CM04) - 
CTLPW(CCO3) - 
UPDPW(CUO2) - 
RDPW(CRO1)- - 

DATA NAME (DATA!) - 
MRPW(DMO04) - 
CTLPW(DCO03) 
UPDPW(DU02) - 
RDPW(DRO1) - 

INDEX (NAME(INDEX1) 
MRPW(IMO4) - 

CTLPW (ICO3) - 
UPDPW(IU02) - 
RDPW(IRO1)}) 

WHICH PASSWORD (5) IS/ARE REQUERED FOR THE POECOWING 
a. TO UPDATE THE INDEX COMPONENT ? 
b TO UPDATE THE DATA COMPONENT ? 
c. TO UPDATE THE DATA SET (FILE1) ? 
d TO DELETE THE DATA SET (FILE1) ’ 


10 e ntaes ane mesmnaseesnmeamnegeneteeeneeeeneenenne eine 


PASSWORD PROTECTION EXAMPLE 2 


DEFINE CLUSTER (NAME(FILE2) 
MR PW (null) 
CTLPW(null) 
UPDPW(null)  - 
RDPW(null) 
DATA NAME(DATA2) 
MRPW(D2M04) 
CT LPW(D2C03) 
UPDPW(D2U02} 
RDPW(D2R01) - 
INDEX (NAME(INDEX2) - 
MRPW(12M04) 
CT LPW(12C03) 
UPDPW(I2U02) 
RDPW(I2R01) ) 
WHICH PASSWORD (S) IS/ARE REQUIRED TO DO THE FOLLOWING 
a, UPDATE THE DATA COMPONENT (DATA2) ? 
b. READ THE INDEX COMPONENT (INDEX2) ? 
on READ THE DATA SET (FILE2) 
d. DELETE THE DATA SET (FILE2) 


H.4.7 


VSAM INTEGRITY 


CONTROL INFORMATION SECURITY 
Uoe OF FREE. SPACE 

INDEX UPDATED ONLY ON SPLIT 
SPLIT SEQUENCE CONTROL 
SOFTWARE EOF 

WRITE CHECK OPTION 


CONTROL INTERVAL SPLIT SEQUENCE 


l. TARGET Cl IS DIVIDED INTO TWO 
Cl's IN PRIMARY STORAGE 

2. RECORD TO BE INSERTED IS PLACED 
IN THE PROPER Cl IN PRIMARY 
STORAGE 

3, NEW Cl IS WRITTEN TO A SPARE Cl 
IN THE GIVEN CA ON SECONDARY 
STORAGE 

4. SEQUENCE SET RECORD IS UPDATED IN 


PRIMARY STORAGE AND WRITTEN TO 
SECONDARY STORAGE 

>. UPDATED TARGET CI IS WRITTEN TO 
SECONDARY STORAGE 


SMF RECORDS AND VSAM 


TYPE 68 — VSAM ENTRY RENAMED 

TYPE 63 — VSAM ENTRY DEFINED 

TYPE 67 — VSAM ENTRY DELETED 

TYPE 69 — DATA SPACE DEFINED, DELETED 
OR EXTENDED 

TYPE 64 -— DATA SET CLOSED OR EOV 

TYPE 62 —- DATA SET OPENED 


DATA & INDEX UPDATE (AMDSB) TIMESTAMP 


ea \ 


CATALO TU sone 


(I: 


fo 
| 
Pee 


ue DAY J 


TO CORRECT: VERIFY 
OR 
UNLOAD, SORT, RELOAD 


1.5 4 


a 


wh, 
f= 


Cc DATA & INDEX CREATION TIMESTAMP 


saa 

| VOLOO1 CREATED 
ae 
- 


| VOLOO2 CREATED 


a 


oa \ 


E ha | 
l CREATED ‘ 
| | 12/1 | 
XQ 
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VOLUME TIMESTAMPS 


if fa. ‘\ 


L “my 


BACKUP / RECOVERY CONSIDERATIONS 


@ NECESSITY FOR BACKUP 


@ BACKUP 
FREQUENCY 
- TIME REQUIRED 
- EASE 


@ RECOVERY 
- POSSIBLE FREQUENCY 
- TIME REQUIRED 


- EASE 
@ SECURITY 
e =I NTEGRITY 
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TYPES OF RECOVERY 


REPAIR 
RESTORES ADDRESSABILITY AND ACCESS TO 
THE CURRENT VERSION OF THE DATA 


RESET 
RESTORES ADDRESSABILITY AND ACCESS TO A 
PREVIOUS VERSION OF THE DATA 


RECOVERY TOOLS 


NON-RECOVERABLE CATALOGS 
EXPORT/IMPORT 
REPRO 
IEHDASDR 
VERIFY 

RECOVERABLE CATALOGS—ADDITIONAL TOOLS 
EXPORT RA/IMPORTRA 
LISTCRA (COMPARE) 
ALTER (REMOVE VOLUMES) 
DELETE (FORCE) 
RESETCAT 


RESET 
RESET/REPAIR 
RESET 
REPAIR 


RESET/REPAIR 
ANALYSIS 
RESET/REPAIR 
RESET/REPAIR 
REPAIR 
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a a EI ET TE TS TE a 
RECOVERY FACILITIES FOR VSAM 


ACCESS METHOD SERVICES 


REPRO 
EXPORT/IMPORT 
VERIFY 
EXPORTRA/IMPORTRA 
LISTCRA 

RESETCAT 


USER PROGRAM - JOURNAL 
SMF 
IEHDASDR 
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av 


BACKUP / RECOVERY ALTERNATIVES 


e SPIN-OFF DATA SETS 


e USER WRITTEN PROGRAMS 


@ REPRO 


e@ EXPORT / IMPORT 


e JEHDASDR 
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VSAM VOLUMES 


° A GIVEN VOLUME CAN BE OWNED BY 
ONE AND ONLY ONE CATALOG 


e OWNERSHIP INDICATED WHEN SPACE OR 
CANDIDATE VOLUME DEFINED 
FORMAT 4 FLAG 
CATALOG VOLUME RECORD 


e RETURN OF VSAM VOLUMES 


DELETE DATA 


DELETE SPACE 


Wh Ve 


PROBLEMS REQUIRING RECOVERY 


DATA SET NOT PROPERLY CLOSED 
@ INCORRECT HIGH RBA IN CATALOG 
e@ INCOMPLETE WRITE TO DASD 
e DUPLICATE DATA 


DATA SET INACCESSIBLE 
@ DATA SET CANNOT BE OPENed 
@ DATA SET COMPLETELY UNREADABLE 
@ DATA SET PARTIALLY UNREADABLE 


UNUSABLE CATALOG 
@ MANY VSAM DATA SETS CANNOT BE OPENed 
@ THE CATALOG CANNOT BE OPENed 
e@ THE CATALOG VOLUME IS NOT USABLE 


H.5.13 


COPY A CATALOG (MVS ONLY) 
: hy. ‘ b ee, s, Pots te ‘ 
> . one fo Waws ys tucloce ) 
BEFORE COPYCAT 


| VOL1 
| 
| SOURCE CAT 
| (Vv) VOL1 
) (V) VOLS 
epee ee ne er See ee ona 
AFTER COPYCAT 
eer — aa lamas ces FE NES = 
VOL1 VOLS VOLT 


TARGET CAT 
(V) VOLT 
(V) VOLS 


(V) VOL1 4 
Source C& 


SOURCE CAT 
(V) VOLS 
(Vv) VOL1 


NS SN Sl i fa A | 


CATALOG RECOVERY AREA FUNCTIONS: =» “#2 % 
ACCESS METHOD SERVICES ) 


LISTCRA. LISTS CRA OBJECTS 
DUMPS CRA RECORDS 
COMPARES CRA WITH CATALOG 


RESETCA: COMPARES CRA AND CATALOG 
REBUILDS CATALOG FROM CRA 


EXPORTRA EXPORTS FILES USING CRA 
MULTIPLE FILES ON SINGLE MEDIUM 


IMPORTRA IMPORTS FILES FROM COPY 
CREATED BY EXPORTRA 


« H.5.15 


CRA RECORD RELATIONSHIP nf, fe et? 


bie! Be Panes 


CATALOG CRA 


SoS oi Gayutien Pe a aalazet ert ie 
a es (C) | cra}ioo [pfreo Ji | avo PE: ttc 


100 ts 


(1) 250 


THE ASSOCIATION THAT IS IN THE CATALOG IS NOT IN THE CRA 


: PHEREL ARLE NO POINTE RS JOINING Cl’s 100,101 AND 250 IN THE CRA 


Hoy Ih 


Cc 


COMPARING OR LISTING THE CRA 


LISTCRA COMMAND 
@ WITHOUT COMPARE OPTION 
LISTS NAME, TYPE, AND VOLUMES OF ALL OBJECTS 
“DEFINED” IN THE SPECIFIED CRA, OR 
— PRINTS ALL CRA RECORDS IN DUMP FORMAT 
@ WITH COMPARE OPTION 
— COMPARES CRA RECORDS WITH APPROPRIATE RECORDS 
OF A SPECIFIED CATALOG 
— LISTS OR DUMPS ALL NON-MATCHING CRA ENTRIES AND 
THEIR EQUIVALENT IN THE SPECIFIED CATALOG 


H.5.17 


Fm ge ee ee ST a RS aT a aa Tar a 


LISTCRA DUMP COMPARE 


THE CRA RECORD IS ALWAYS USED AS 
THE BASE FOR COMPARISON 


EXAMPLE 1 


Aaa a ge 
crarco | |..[t}s|tig|............ |DspiR1 |DSDIR2 | 


“MISCOMPARE DATASET DIRECTORY’ WILL ALWAYS BE 
ISSUED BECAUSE DSDIR2 COMPARES INCORRECTLY. 


EXAMPLE 2 


END OF S 


coanco [Te] dso 


carneo [T [re]rep soins [sore 
PN ee ee 


THE MESSAGE ISSUED MAY BE “OTHER BFCAUSF 
THE DATASET DIRECTORY FIELD COMPARLS CORRECILY, 


OF 
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LISTCRA WITH COMPARE OPTION 


LISTCRA INFILE (CRA1 CRA2) — 


COMPARE —- 

NAME — 

MASTERPW(MSTPW) — 

CATALOG (USER.CATALOG/UMSTPW UCAT) 
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EXPORTING DATA BASED ON THE CRA 


EXPORTRA COMMAND 


USED TO RECOVER VSAM CATALOG ENTRIES AND DATA 
BY MEANS OF THE CATALOG RECOVERY AREA 
INFORMATION RECOVERED IS RECORDED ON A PORTABLE 
MEDIUM, MULTIPLE DATA SETS ON SINGLE PORTABLE 
MEDIUM 

SPECIFIABLE OBJECTS. ALTERNATE INDEXES, CLUSTERS, 
USER CATALOGS. NONVSAM 

PATHS ARE AUTOMATICALLY EXPORTED WITH PATH 
ENTRY CLUSTER 

REFCOVFRY VOLUMF MUST BE MOUNTED 


H 5.20 


//STEP 1 
//DD2 

//DCRA1 
//DCRA2 
//DCRA3 


//OUTFILE 


EXPORT BY MEANS OF CRA 


EXEC PGM=TDCAMS 

DD UNIT=(3330,2) ,AMP='AMORG' , DISP=OLD, VOL=SER= (VOL02,VOL03) 
DD UNIT=3330,VOL=SER=VOL01,AMP='AMORG' 

DD UNIT=3330,VOL=SER=VOL02,AMP='AMORG' 

DD UNIT=3330,VOL=SER=VOL03,AMP='AMORG' 

DD UNIT=2400,VOL=SER=TAPE1 , DSN=BACKUP 


//SYSPRINT DD SYSOUT=A 
* 


//SYSIN 


DD 


EXPORTRA CRA ( ( DCRA1 ENTRIES ((VSAM.CLUSTER ) ) ) - 


( DCRA2 ALL INFILE (DD2 ) } - 
( DCRA3 NONE ) ) - 


OUTFILE (OUTFILE) - 
MASTERPW (MASTER) 


H.5.21 
IMPORTING DATA RECOVERED BY EXPORTRA 
IMPORTRA COMMAND 
e@ USED TO IMPORT OBJECTS ON A PORTABLE MEDIUM CREATED 
BY EXPORTRA 
@ AUTOMATIC DEFINITION OF OBJECTS ON PORTABLE MEDIUM 
@ ALREADY EXISTING OBJECTS ARE AUTOMATICALLY REPLACED 
BY OBJECTS ON PORTABLE MEDIUM 
@ RECOVERY VOLUME MUST BE MOUNTED 
H.5.22 


IMPORTRA EXAMPLE 


//1MP EXEC PGM=IDCAMS 
//INDD DD DSN -EXPORTRA.DATASETS, VOL :SER TAPE], ... 
//OUTDD DD DSN-ANYNAME.NOTIN,DISP OLD, 


// VOL SER-(VOLTIT,VOL222 VOL333) UNITE 3330, 
if AMP='AMORG’ 
/ISYSPRINT DD SYSOUT=A 
/ISYSIN DD * 
IMPORTRA INFILE (INDD) — 
OUTFILE (QUTDD) 


RESETCAT FILES 


A. CAT-10O-BE~RESET WORKFILE WORKCAT 


os. VSAM OWNED 
ahve ape Gost he 5! USERCAT 


Pat 


B. CAI TO BE RESET WORKFILE WORKCAT 
OWNED 
DEVPIACAT Tene Sy 


C. CAT Tu BE RESET WORKKE ILE WORKCA 
__3 VSAM 4 
DEPTACAT HRDS = >€-- 
po og TS 
ee po 


| | ; H 5.24 
i bees ( dtot 


RESETCAT LOGIC 


SIMPLIFIED REPLACE/INSERT/DELETE LOGIC 


ENTRY IN CRA Y 


ENTRY IN CATALOG Y 


REPLACE 
ENTRY 
IN 
| CATALOG 


INSERT 
ENTRY 
IN 
CATALOG 


DELETE 
ENTRY 
IN 
CATALOG 


ASSOCIATION CHECK 


— MANY RECORDS IN THE VSAM CATAIOG CONTAINS Cl 
NUMBERS TO OTHER CATALOG RECORDS. 


— FOR EXAMPLE 


VOLUME 


EXTENSION 


— ALL Cl#s IN THE RECORDS ARE CHECKED FOR CORRECT 
ASSOCIATION. 


H.5.25 


DATA SPACE ACCOUNTING 


sc al 


| VOLUME RECORD | 
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SPACE CONSISTENCY CHECK 


e FROM VOLUME RECORD SPACE HEADER BUILD A BIT MAP 


e FOR EVERY TRACK OCCUPIED BY ‘DSA’ ZERO OUT 
CORRESPONDING BIT 


110000 1 


‘DSA’ 


¢ DO THE SAME FOR ‘DSB’ 


‘DSA’ 


INDICATES SPACE CLAIM 
IN CONFLICT 


‘DSB’ 


e ‘DSB’ WILL BE MARKED USUSABLE, 8 TRACKS FREED UP 


FREED UP H.5.28 


“ 


RENAME EXAMPLE 


CATVOL ABCVOL 


BEFORE = | c DS.xYZz| ae 
RESET: 
A DS.XYZ 


CRa 
AFTER A | DS.XYZ | 
RESET: 


G.N.=TXXXXXXX.VSAMDSET.DFDYYDDD.TYYYYYYY H.5.29 


PROCEDURES TO TAKE BEFORE RESETCAT 


LISTCAT ALL ON THE CATALOG TO BE RESET. 
LISTVTOC ON ALL THE VOLUMES TO BE USED IN RESET. 


LISTCRA COMPARE DUMP SHOULD ALSO BE “TAKEN. 
(OPTIONALLY, PRINT THE CATALOG AND LISTCRA 
SDUMP). 


THE CATALOG OR THE CATALOG VOLUME SHOULD BE 
BACKED UP. 


THE VOLUMES TO BE USED FOR RESET SHOULD BE 
DUMPED. 
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PROCEDURES TO TAKE AFTER RESETCAT 


EXAMINE THE MESSAGES! 
LISTCAT ALL 
LISTCRA COMPARE ON THE RESET VOLUMES 
DATASETS MARKED NOTUSABLE? 
DELETE 
ENTRIES RENAMED? 
ALTER 
CHANGE JCL OF PROCESSING PROGRAMS 
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RESETCAT COMMAND 


RESETCAT CATALOG ( CATNAME [DNAME] ) 
CRAVOLUMES ((VOIL3ER [DEVTYPE] )(... .. | 
CRAFILES ((ONAME { ALL | NONE} ).. . 21) 
[WORKFILE (ONAME):! 
[WORKCAT (CATNAME)] 
[MASTERPW (PASSWORD)| 
[IGNORE | NOIGNORE] 


H 5.32 


RESETCAT EXAMPLE 1 


C //RESTOR EXEC PGM:IBCAMS 
om //STEPCAT DD DSN USERCAT,DISP =SHR 
// DD DSN DEPTACAT,DISP -OLD 
/TONAME DD DSN DEPTACAT,DISP OLD 
//\WF DD UNIT 3330,VOL SER-MV00/5,DISP -OLD,AMP AMOKG 
//VOL1 DD UNIT=3330, VOL=SER=VOLO01,DISP=OLD,AMP=AMORG 
//VOL2 DD UNIT=3330,VOL=SER=VOLO002,DISP=OLD,AMP=AMORG 
//SYSPRINT DD SYSOUT=A 
/ISYSIN DD i 
RESETCAT CATALOG (DEPTACAT DNAME) + 
WORKCAT (USERCAT) WORKEILE (WE) | 


CRAFILES ( (VOLI ALL) + 
(VOL2 ALL) ) 


H 5.33 
bad ‘ 
= a ee 2 WHICH VOLUMES FOR RESETCAT? 
en : pie 
: ade oe He 
<> <-> aa tet 
/ 
ee é. ‘ “ 
ed 
PH.KR 
DATA 
{ 
es : 
MISCOMPARE! ‘ 
{ ee. . 
cn | f 
« 
ee / { ts ( i? { 
Le, ee L ols 
( H 34 
ao uv | ¢ - ; L : - : : Cc ie ° > } [ ! or Pea ude , Care ao hes BS 
c aes 
¢ + t f ! 4 a : ¢ ‘ = 
- ; sae ! a 
/ ‘ : ae a. ‘ (ic i Ose & 


a 


BEFORE RESETCAT: 


PHCAT 
NONVSAM IN e 
CRA OF CATALOG 
VOLUME 
CRA 
AFTER RESETCAT 


FORCED RELEASE OF VOLUME OWNERSHIP 


RESETTING INTO A NEWLY DEFINED CATALOG ™%. 


CRA (A)NVSAMX.VOL1 


@ DELETE FORCE | uc ee 


(A)NVSAMX,VOL1 
(AJNVSAMX,VOL1 


CATVOL ot sa > 


a ay eer 
CATVOL NEWVOL I 


Amante 


DATA SPACE ff (A)NVSAMX,VOL1 


/ 
/ 
/ 
/ 
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t 
i 


aa 


—~ SCRATCHES AND RETURNS NON-EMPTY VSAM DATA SPACES 
TO VTOC 


— RELEASES VOLUME OWNERSHIP 


— MARKS ALL CATALOG ENTRIES FOR VSAM DATA SETS OF 


RELEASED VOLUME AS UNUSABLE, ENTRIES ARE NOT DELETED 


r 
7 
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Cc 


) 


el 
ee 


ACTIONS WHICH CAUSE MISMATCHES 
FROM A BACKUP CATALOG 


DEFINE / DELETE / EXTEND DATA SPACE 
- VOLUME ENTRY IN BACKUP CATALOG NO 
LONGER VALID 


DEFINE / DELETE DATA SETS 
- VOLUME ENTRY IN BACKUP CATALOG NO 
LONGER VALID 


- DATA SET ENTRIES (SOME) IN BACKUP 
CATALOG NO LONGER VALID 


DATA SET EXTEND VIA SUBALLOCATION 
- VOLUME SPACE MAP IN BACKUP CATALOG 


NO LONGER VALID 


- DATA SET ENTRY (ONE) IN BACKUP CATALOG 
NO LONGER VALID 
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H.5.50 


CONTROL INTERVAL FORMAT 


rn Interval a 


Free 
“tal “FiB) TMC) | ER(D) | Spaces) 
Logical ony . System 
Control Information 


* Since logical records LR icy and LR(p) are of 


CIDF (ey 
(Free Space) 


equal length, RDF ic) and (D) tells the system 
that LR ip) is the same size as L Ric). 


H.6.1 


Control Interval Definition Field 
(CIDF) 


[fe PO} ik Fs | 


DD FS 2 Bytes: Offset from the beginning of the 
control interval to the free space 
areas. 


LL FS 2 Bytes: Specifies the length of the free 
space area within the control 
interval. ae 


RECORD DEFINITION FIELD (RDF) 


pe] ow | 


R 1 BYTE; CONTROL INDICATORS 


BIT POSITION 


2-3 


INDICATION 
RESERVED (SET TO O). 


NO ADDITIONAL CONTROL 
INFORMATION RELATED TO THIS 
RDF FOLLOWS. 


ADDITIONAL CONTROL INFORMATION 
RELATED TO THIS RDF FOLLOWS. 


NOT SPANNED RECORD 


FIRST SEGMENT 
LAST SEGMENT 


INTERMEDIATE SEGMENT 
SINGLE-RECORD DESCRIPTOR. 
REPLICATION COUNT DESCRIPTOR. 
SLOT CONTAINS RECORD-RRDS 
SLOT EMPTY-RRDS 

RESERVED 


LL 2 BYTES; LENGTH OR COUNT 


eel 


ACB 
RPL 


ACCESSING A CONTROL INTERVAL 


MACRF=(CNYV.... 
OPTCD=(CNV.... 


— WITH USER BUFFER MANAGEMENT 


ACB 
RPL 


MACRF=(CNV,UBF.,... 
OPTCD=(CNV,MVE,...), AREA=BUF 


— WITH “IMPROVED” Cl PROCESSING 


ACB 
RPL 


MACRF=(CNV,UBF,ICI.... 
OPTCD=(CNV, MVE...) AREA=BUF 


— WITH FIXED CONTROL BLOCKS 


ACB 
RPL 


MACRE =(CNV,UBF,ICI,CFX.... 
OPTCD=(CNV,MVE.,,...), AREA=BUF 


H.6.3 


H.6.4 


INDEX RECORD GENERAL FORMAT 


FREE UNUSED 
HEADER CI’S SPACE 


INDEX INDEX INDEX 
ENTRIES ENTRIES ENTRIES 


DISPLACEMENT 
FROM SECTION 
TO SECTION 


H.7.1 


LENGTH OF 
POINTER IS 
IN HEADER 


nae nena 
(v) (1) (1) (1-3) 
K 
i L Pointer 


\¢—_-____—_- Index Entry -__—_—+_—_—}| 
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H.7.3 


I/O CONTROL BLOCKS 


ACB TIOT 


XS FL I 


replaces 


CHANNEL 


DEBS PROGRAMS 


CLUSTER 


CLUSTER CONTROL BLOCKS 


RPL 


DESCRIBE 


REQUEST ACB 


1 AMBL 


DESCRIBE 
DATA 
SET 


FORMAT 
WRITE 


UPDATE 
WRITE 


lIOBS 


DATA 
INDEX 


H.8.1 
AMBL AMB-DATA 
t DATA AMB 
f INDEX AMB 2a 
AMB-INDEX 
Ci# IN CAT 
H.8.2 


COMPONENT CONTROL BLOCKS 


AMB 
EDB 
t EDB 
RBAs 
EXTENTS 
t LPMB CCWs 
BUFC CPA 
RBA A CCWs 
t CPA 
t BUFFER chal 
aii [ 
t PLH + BUFC 
7< 
ae 
| PLH \ 
H.8.3 
PLACEHOLDERS & BUFFERS 
PLH BUFC INDEX BUFFER 
— [sd 
BUFFER anh 
t CPA CH PG 
+ BUFFER 
SEEK AD 
PLH 


a PLH 


t PLH 


BUFC DATA BUFFER 


CH PROG 


CPA 
meas 


H.8.4 


Cc 


SHARED RESOURCES 


@ SHARE CONTROL BLOCKS & BUFFERS 

e REDUCED STORAGE REQUIREMENTS 

e DEFERRED WRITES 

@ RELATE I/O OPERATIONS 

e FOR RANDOM OPERATIONS 

@ USER CODE OR PACKAGE 

@ LOCAL SHARED RESOURCES (LSR) 

e MVS ONLY: GLOBAL SHARED RESOURCES (GSR) 


ere er PEE tS SS 


BUILD & USE THE RESOURCE POOL 


BLDVRP BUFFERS=(512(5),1024(B),4096(5)), 
STRNO=10,KEYLEN=12 


CUST ACB MACRF=(LSR,DFR,. ..),.-- 


H.8.5 


H.8.6 


BUFFER POOL EXAMPLE 


512 SUBPOOL 
1024 SUBPOOL 


4096 SUBPOOL 


H.8,7 
WRTBFR MACRO 
WRTBFR- RPL=any,TYPE=ALL 
WRTBFR- RPL=name,TYPE=LRU(50) 
WRTBFR RPL=name,TYPE=TRN 
WRTBFR RPL=name,TYPE=DS 
H.8.8 


THE “DISP’” PARAMETER 


//MYDATA DD DSNAME=MY.VSAM.CLUSTER,DISP=OLD 


exclusive enq for dsname 


//OTHER DD DSNAME=MY.OTHER.CLUSTER,DISP=SHR 


check shareoptions 


VSAM SHAREOPTIONS 


e PROVIDE DATA INTEGRITY WHILE SHARING FILES 


e@ SPECIFY AMOUNT OF SHARING: 


— ACROSS REGIONS 


DEFINE SHR (1, 3) 


— ACROSS SYSTEMS 


H.9.1 


H.9.2 


a 
w ala 


SHARE OPTION 1 
ALTERNATE INDEXES 


UPGRADE SET 


OPEN OUTPUT 


PATH 1 
(UPDATE) 


BASE 


CLUSTER 


H.9.3 


SHAREOPTION 2 
WRITE INTEGRITY 


— OPEN FOR SEVERAL INPUTS AND ONE OUTPUT 


H.9.4 


SHAREOPTION 2 


ERROR= 


OUTACB ACB 


OPEN ACBNAME 


ACBNAME 


ACs ...IN, 


OPEN ACB1 


ACB1 


VIRTUAL STORAGE 


SHAREOPTION 3 
NO INTEGRITY 


PROCESSING FOR 
~ SEVERAL INPUTS AND SEVERAL OUTPUTS 


VSAM DOES NOT MONITOR THE ACCESSING TO 
ENSURE DATA INTEGRITY 


H.9.5 


H.9.6 


SHAREOPTION 4 — NO INTEGRITY 
BUT HELP FROM VSAM 


@ SEVERAL INPUTS AND SEVERAL OUTPUTS 
@ LIMITED AID FROM VSAM => 4. | a ae 
@ RESTRICTION ON PROCESSING . . 

@ USER RESPONSIBILITY FOR INTEGRITY 


H.9.7 


SHARING WITHIN A REGION 
FULL INTEGRITY 


@® MULTIPLE STRINGS: ACB STRNO=# 

@ REQUEST FAILS IF 
Cl ALREADY HELD BY OTHER STRING 
Cl OR CA SPLIT IN PROGRESS 


HO 


eae een tere eneetdieineneneneeenenmeneel 


ae 


SHARING ACROSS SYSTEMS 


SYSTEM SYSTEM 
A B 


VSAM 


DEFINE SHR (X, 3) 
or 
SHR (X, 4) 


H.9.9 


SHARING A CATALOG WITHIN A SYSTEM 


a @ TOTAL INTEGRITY 
| CATALOG @ UP TO 7 CONCURRENT REQUEST 
e BUFFER SPACE 
512 — EXTRA BUFFER 
1K — PER STRING 


H.9.10 


SHARING A CATALOG ACROSS SYSTEMS 


SYSTEM SYSTEM 
A B 


CATALOG 


@ COMPLETE INTEGRITY 
@ NO RESTRICTIONS 


H.9.11 


) 


VSAM OPTIMIZATION 


Cl SIZE e BUFFER SPACE 

CA SIZE e FREE SPACE 
ALLOCATION e MULTIPLE VOLUMES 
INDEX OPTIONS @ SPEED/RECOVERY 
KEY COMPRESSION e 3350 


H.10.1 


Cl SIZE CONCERNS 
e DASD UTILIZATION 


e MULTIPLE BLOCKS 
e SPANNING A TRACK 


H.10.2 


CONTROL INTERVAL SIZE 
GENERAL PROCESSING GUIDELINES 


e SEQUENTIAL/SKIP SEQUENTIAL 


LARGER DATA Cl IMPROVES PERFORMANCE WITHIN 
THE TASK 


e DIRECT 


SMALLER DATA Cl IMPROVES PERFORMANCE WITHIN 
THE TASK 


e SEQUENTIAL/SKIP SEQUENTIAL AND DIRECT 
SMALLER DATA Cl 


MULTIPLE BUFFERS WHEN PROCESSING SEQUENTIALLY 


H.10.3 
Cw 
BUFFER SPACE 
SPECIFIED IN 
e DEFINE 
e ACB (OVERRIDES DEFINE)* 
e // DD (OVERRIDES ACB & DEFINE)* 
“MUST NOT BE LESS THAN VALUE OF DEFINE 
H.10.4 


SCHEDULING BUFFERS — DIRECT 


STRING 1 | STRING 2 
DATA DATA 
BUFFER 1] BUFFER 2 


DIRECT GET 
FROM CA, 


IS5 IS3 IS, 


SS; SS SS SS, SS SSp SS7 SSg SSg S51q SS), SS19 


H.10.5 
INDEX BUFFERS RECOMMENDATION 
DIRECT: 
MIN = #LEVELS — 1 + STRNO 
MAX = #INDEX SET RECORDS + STRNO 
SEQUENTIAL: 
STRNO 
H 10.6 


SCHEDULING BUFFERS — SEQUENTIAL/SKP 


DATA BUFFER 1 DATA BUFFER 2? DATA BUFFER 3 
—r az | Sd 
a 
SRS | Oe 
al 


ASSUME 3 DATA BUFFERS 
1 INDEX BUFFER 
6 CIS PER CA 
2 RECORDS PER Cl 


H.10.7 


CA SIZE 
e GOOD PERFORMANCE WHEN ENTIRE CAs NUMBER IN CYLINDER 


e THE LARGER THE CA: 
— THE FEWER THE PROBABILITIES OF CA SPLITS 
— THE FEWER THE READS OF SEQUENCE SET RECORDS 
— THE MORE CONSOLIDATED THE INDEX 


H.10.8 


C 


FREE SPACE EXAMPLE 


FSPC (20,10) CISZ (40 96) RESCZ (500,500) 
119 Cls/CA 


REC’D REC’D REC'D REC’D REC'D REC’D 
1 2 3 4 5 6 : 


BYTE # 500 1000 2500 3000 4086 
3266 CIDF 
FREESPACE RDFS 
THRESHOLD 
H.10.9 
FREESPACE CONSIDERATIONS 
® LARGE FREESPACE 
— MORE DASD SPACE 
— MORE 1/0 FOR SEQUENTIAL PROCESSING FOR SAME 
NUMBER OF RECORDS 
— MORE LEVELS OF INDEX, SO POSSIBLE INCREASE 
IN RUN TIME FOR DIRECT PROCESSING 
@ SMALL FREESPACE 


MORE CI/CA SPLITS 


AFTER SPLITS, MORE TIME FOR SEQUENTIAL 
PROCESSING WHEN FILE NOT IN PHYSICAL 
SEQUENCE 


H.10.10 


FREE SPACE ESTIMATION 
EVALUATE PRECENT AND UNIFORMITY OF GROWTH 
GROWTH 


@ EVENLY DISTRIBUTED 
— SPECIFY THAT PERCENT AS FREE SPACE 


e UNEVENLY DISTRIBUTED 
— SPECIFY SMALL PERCENT OF FREE SPACE 
— LOAD THE DATA SET 
— ALTER PERCENT OF FREE SPACE 


H.10.11 
c. L. 
WoLs : 
MULTIPLE VOLUME SUPPORT 
SPACE ALLOCATION cs 
“a é % if fo ee a 
"A PRIMARY ALLOCATION ON EACH VOLUME es ae ea em 


® WITHOUT KEYRANGE 
ACQUIRED FROM FIRST VOLUME WITH DEFINE 


ACQUIRED FROM OTHER VOLUMES WHEN 
NEEDED FOR EXTENSION OF FILE 


e WITH KEYRANGE 


ACQUIRED FROM EVERY VOLUME WITH 
DEFINE 


H.10.12 


EXAMPLE 1 


DEFINE e 
@ 


° CARB 
VOLUMES (x Be) 


CYLINDERS (50 5) 


EXECUTION TIME EXTENSION 


DEFINE 
e@ PRIMARY SPACE ACQUIRED FROM FIRST VOLUME 
, ; xg - 4 f 
(NEED NOT BE VOLUME A)? te SO oe aa nM p f- 
EXECUTION 7 


e USE REMAINING SPACE ON VOLUME IN SECONDARY EXTENTS 


e IF MORE SPACE REQUIRED TAKES PRIMARY ALLOCATION 
FROM NEXT VOLUME 


e REPEAT EXECUTION ALLOCATIONS 


H.10.13 


EXAMPLE 2 


DEFINE bd 
-  @ 


@ 
VOLUMES (A B C) 
~ 3 KEYRANGES ((00 30) (31 65) (66 99)) 
~---—--—-—> UNO RDERED 
CYLINDERS (50 5) 


(31-65) 


EXECUTION TIME EXTENSION 


DEFINE 
e PRIMARY ALLOCATION TAKEN FROM EACH VOLUME 


NOTE: IF ANY VOLUME DOES NOT HAVE SPACE FOR PRIMARY, 
SEVERAL MAY BE PLACED ON SAME VOLUME 


EXECUTION 


@e SECONDARY ALLOCATIONS FOR A KEYRANGE WILL BE ON VOLUME 
OF ITS PRIMARY ALLOCATION 


H.10.14 


we 


UNORDERED/ORDERED 


UNORDERED 


ORDERED 


PRIMARY ALLOCATION" MUST BE AVAILABLE ON ONE 
OF SPECIFIED VOLUMES OR DEFINE FAILS 


SECONDARY ALLOCATION MAY BE OBTAINED FROM 
ANY VOLUME 


SPACE IS ALLOCATED“ ON VOLUMES IN THE ORDER 
SPECIFIED IN THE VOLUMES PARAMETERS 


PRIMARY ALLOCATION MUST BE AVAILABLE ON FIRST 
VOLUME SPECIFIED OR DEFINE FAILS 


"PER KEY RANGE IF SPECIFIED 


H.10.15 


EXAMPLE 3 


DEFINE e 
6 


; ; 
a 
@ ‘ tes 
, 


VOLUMES (A B C) ror = 
ORDERED a 


CYLINDERS (50 5) : ese, tit 


EXECUTION TIME EXTENSION 


DEFINE 
e PRIMARY ALLOCATION TAKEN FROM VOLUME A OR DEFINE FAILS 


EXECUTION 
e USE REMAINING SPACE ON VOLUME A IN SECONDARY EXTENTS 


e IF MORE SPACE REQUIRED TAKE PRIMARY ALLOCATION FROM 
VOLUME B; IF NOT POSSIBLE, REQUEST IS REJECTED 


e REPEAT FOR VOLUME C. 


fy ” ’ * 
ye Z. H.10.16 
ae ee ae a =, f w S . 
Be og! 3 \ a Hi Pe = 
: we Me : - ie * 


INDEX OPTIONS 


e INDEX AND DATA ON SEPARATE VOLUMES 
— SIMULTANEOUS ACCESS TO INDEX AND DATA 
- INDEX ON FASTER DEVICE 
- SPECIFY VOLUMES AT DATA AND INDEX LEVELS 


e SEQUENCE SET IMBEDDED IN CAs 
— SEQUENCE SET ALSO REPLICATED 
— DISK ARM MOVEMENT REDUCED 
— SPECIFY IMBED AT EITHER CLUSTER OR INDEX LEVELS 


e INDEX RECORDS REPLICATED 


— INDEX SET AND SEQUENCE SET REPLICATED 
—- ROTATIONAL DELAY REDUCED 
— SPECIFY REPLICATE AT EITHER CLUSTER OR INDEX LEVELS 


H.10.17 


SS, SS 


INDEX OPTIONS* — Vey Wit 


“2 VOLUMES ARE SHOWN, COULD BE 2 AREAS 
ON 1 VOLUME 


H.10.18 


RECOVERY EXAMPLE 


PREFORMATTING 


| 00000 ——$—___—_—_—-——+| cipF | 
| 00000 SSS eee CIDF | 
| 00000 Se CIDF | 
| 00000 ——_—___—_________ | CIDF | 


| SEOF | 
ena 
a 
ee nee: 


LOADING 
10 | 15 | 20 RDF| RDF! CIDF 
30 | 35 | 40 RDF|RDF| CIDF 
50 RDF] CIDF 


| [ CIDE | 


CAI 


CA2 


CAl 


CA2 


H.10.19 


SPEED EXAMPLE 


LOADING 
10 15 20 RDF |RDF|CIDF 
30 35 40 RDF |RDF|CIDF 
CA1 
50 RDF|CIDF 


H.10.20 


INDEX KEY COMPRESSION 


MINIMIZE KEY SIZE 

MINIMIZE BYTES EXAMINED 

MAXIMIZE INDEX FAN-OUT 

FEWER INDEX LEVELS ——@ FASTER KEYED ACCESS 
FRONT COMPRESSION 

REAR COMPRESSION 

DIFFERENCES BETWEEN KEYS — NOT IDENTIFICATION 

OF COMPLETE KEY 

INDEX ONLY — KEYS NOT COMPRESSED IN DATA RECORD 


H.10.21 


REAR KEY COMPRESSION 


Cl 2 
CONTROL COMPLETE KEY AFTER REAR 
INTERVAL KEY KEY COMPRESSION 
Cl 1 (10001) * 1000-- 
10009 ** 
Cl 2 (10052) 100—— 
10080 
Cl 3 (10222) 10333 
10333 
Cl 4 (10334) 1400- 
14000 
Cl 5 (14021) ——— 
14028 
Cl 6 (23456) 2363— 
23630 
Cl 7 (23685) 


"FIRST KEY IN THE CONTROL INTERVAL 
**LAST KEY IN THE CONTROL INTERVAL 


H.10.22 


FRONT KEY COMPRESSION 


js 
Cl 1 
CONTROL COMPLETE REAR KEY AFTER FRONT 
INTERVAL KEY COMPRESSION KEY COMPRESSION 
Cl 4 10009 1000 - 1000 
Cl 2 10080 100 
Cl 3 10033 10333 = = 333 
Cl 4 14000 1400 400 
Cl 5 14028 —- | a 
Cl 6 23630 2363— 2363—- 
. H.10.23 
a 
KEY COMPRESSION 
FRONT COMPRESSION 
BEST WHEN MANY KEYS HAVE SAME LEADING 
CHARACTERS 
REAR COMPRESSION 
BEST WHEN KEYS HAVE LARGE DIFFERENCES 
IN RIGHTMOST CHARACTERS 
«C H.10.24 


3850 OPTIONS 
OPEN: BIND 
CYLINDERFAULT 
STAGE 


CLOSE: DESTAGEWAIT 
NODESTAGEWAIT 


H.10.25 


MVS MASTER CATALOG 


VSAM CATALOG STRUCTURE 


ENTRIES FOR SYSTEM DATA SETS 


ENTRIES FOR CATALOGS 


CREATED AT SYSGEN 


LOCATED VIA ‘SYSCATLG’ MEMBER IN 
SYS1.NUCLEUS 


H.11.1 


BACKUP 


@ VOLUME BACKUP WITH STANDALONE RESTORE 


OR 


@® DUPLICATE CATALOG 
DEFINE UCAT 
LOAD UCAT - Eg REPRO 
ENTRY IN SYS1.NUCLEUS 


a Fe 


IPL WITH DUPLICATE CATALOG 


1. ADDRESS STOP AT IEAVNP11 


ee ALTER CONSTANT AT @CCOQ2209 


QUALIFIED NAMES 


USER CATALOG 


MASTER CATALOG 


FO4V.PAYROLL.CLUSTER 
EDCTV.ENROLL.CLUSTER 


FO4V.UCAT 
EDCTV-ALIAS 
SYSCATLG.VOIABCD 
FO4N-ALIAS 
EDCTN-ALIAS 


CVOL 


FO4N.HOURS.5AM 
EDCTN.GRADES.SAM 


H.11.3 


H.11.4 


a ESTABLISH CVOL POINTER 


DEFINE NONVSAM 


NAME (SYSCTLG.VVOLOO1) - 
DEVICE TYPES (2314) - 
VOLUMES (VOLO0O1) 


The first qualifier Must Be ‘SYSCTLG’. 


MASTER 


SYSCTLG.VVOLOO1 


4 H.11.5 


ESTABLISH ALIAS 


DEFINE ALIAS — 
NAME (A) — 


RELATE (SYSCTLG.VVOLO01) 


DEFINE ALIAS NAME (B) RELATE (SYSCTLG.VVOLO001) 


MASTER CVOL 


SYSCTLG.VVOLOO1 


H.11.6 


¢ 


CONVERT CVOL TO VSAM UCAT 


// MVE EXEC IDCAMS 

// OSCAT DD DSN=SYSCATLG,VOL=SER=CAT004, 
/ UNIT=3330 

// SYSPRINT DD SYSOUT=A 

// SYSIN : 


CNVTCAT INFILE (OSCAT) CAT (AECUCAT) 


SYSCATLG: 


EDN.SAVINGS 
EDN.VISUAL 
FO4N.RUNS 


H.11.7 
GENERIC NAMES AND LISTC, DEL, ALTER 
LISTCAT ENTRIES (FO4V.*.PRIOR.CLUSTER) 
will list: FO4V.anyname.PRIOR.CLUSTER 
as in FO4V.ENROLL.PRIOR.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 
\ 
But not 
FO4V.ENR “PRIOR.CLUSTER.ADDED 
FO4V.MAC PRIOR.AIX 
H.11.8 


LEVEL PARAMETER 


LISTCAT LEVEL (F04V) 


includes FO4v.ENROLL.PRIOR.CLUSTER 
FO4V. ROSTER. AFTER.CLUSTER 
FO4V.GRADES.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 


LISTCAT LEVEL (F04V.*.PRIOR) 


includes FO4V.ENROLL.PRIOR.CLUSTER 
FO4V.MACHINE.PRIOR.CLUSTER 


H.11.9 
CATALOG SEARCH ALGORITHM 
Seorch F 
STEPCAT EXIT 
Set 
RC =NF 
6 
Set Fa ea 
s or FLQ= 
( | maa Seorch 

F = Found e H.1110 


NF = Not Found 
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INTRODUCTION 


Virtual Storage Access Method (VSAM) is an access method for use with 
OS/VS1 and OS/VS2. VSAM is used with direct-access storage to provide 
fast storage and retrieval of data. 


VSAM’s record format is different from that of other access methods. All 
VSAM records are stored in control intervals. A control interval is a 
continuous segment of auxiliary storage. The records are ordered according to 
values in a key field or according to when they were stored. With 
key-sequenced data sets, the user can gain access to a record by specifying its 
key or its relative byte address (RBA). With entry-sequenced data sets, the 
user can gain access to a record only by specifying its RBA. For additional 
information on VSAM records and how they are stored, see “‘Data Areas.” 


User programs that contain Indexed Sequential Access Method (ISAM) 
macros can be used to process records in a VSAM data set. The ISAM 
interface program that allows the use of ISAM macros builds the necessary 
VSAM contro! blocks when an OPEN macro is issued and ensures that 
VSAM contro! blocks are properly initialized when subsequent requests are 
made for reading or writing records. 


Most of VSAM resides in the pageable link pack area in the common area of 
virtual storage. Figure 1 illustrates VSAM’s relationship to OS/VS2, to the 
processing program, and to the data stored on a direct-access storage device 
and in mass storage. The subpools indicated in the figure (230, 231, 239, 241, 
245, 250, 252) contain VSAM contro! blocks. For more information see 
“Virtual-Storage Management” in “Diagnostic Aids.” 


VSAM is controlled by user macros. These macros are expanded into calling 
sequences to VSAM functions. For additional information on user macros, 
see OS/VS Virtual Storage Access Method (VSAM) Programmer's Guide 
and OS/VS Access Method Services. 


VSAM communicates with other parts of the operating system through the 
SVC processor and through VS2 control blocks used by VSAM. In addition 
to the VS2 control blocks used by VSAM, VSAM builds and uses the 
access-method control block (ACB). The ACB describes a VSAM data set in 
much the same way that a DCB describes a nonVSAM data set. 


In addition to processing records and data sets, VSAM opens and closes data 
sets and does most of its own space management, that is, VSAM makes only 
minor use of VS2 Open and Close and relies on VWS2 DADSM for only part of 
its space management. To do much of this work, VSAM uses the VS2 catalog. 
VS2 catalogs contain a description of VSAM space, where available space is, 
how space is used, and the location of data sets. For additional information on 
the catalog, see OS/VS2 Catalog Management Logic. 


VSAM is logically grouped into the following functional areas: 


“e Data-Set Management (sometimes referred to in program documentation 


as “I/O Support’), which comprises Open and Close for VSAM and for 
the ISAM Interface, Virtual-Storage Management, and BLDVRP/DLVRP 
processing 


— Open connects a user’s program to a VSAM data set and builds the 
control blocks required to permit the user to read from and write to the 
data set. 
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Virtual Storage 
| igh Ad 
c System Queue Area (Subpool 245) High Address | 
Common Area 
(Global Storage) Pageable Link eer 
Pack Area VSAM) 
~ 
¢ 


User’s Private Address Spaces 


(Local Storage) 
Subpool 250 (1/O Buffers) 


Subpool 252 


Contents of 


Direct-Access 
Control Intervals i : 


Storage 


Data 
Records 


Staged 
Data 


System Area (VSAM 


I/O Management) 


Nucleus 


Mass Storage 


Low Address 


Figure 1. Relationship of VSAM, OS/VS2, User’s Processing Program, and Stored Data 


— Close disconnects a user’s program from a data set and releases the data 
set’s control blocks built by Open. Close also updates statistics in the 
catalog. 


— Virtual-Storage Management centralizes the processing of most requests 
for virtual storage. 


- BLDVRP/DLVRP processing builds and deletes VSAM resource pools 
for processing with local or global shared resources. (Processing with 
shared resources is described from the user’s point of view in OS/VS 
VSAM Options for Advanced Applications.) 

e Record Management, which comprises processing to satisfy user requests 
for access to data, including end-of-volume processing 


— Data-Request Processing requests I/O Management to read and write 
Cc. records in response to user-issued VSAM and ISAM macros (the latter 
by way of the ISAM Interface). It also requests 1/O Management to 4 
read and write records for VS2 Catalog Management. 


18 OS/VSZ2 Virtual Storage Access Method (VSAM) Logic 


me ———— 
een RR sy am tif = 
elaine 


— End of Volume mounts volumes and allocates space. It modifies the 
existing control blocks to reflect the newly mounted volumes and newly 
allocated space. 


Control Block Manipulation, which allows a user’s program to generate 
some control blocks (ACB, EXLST, and RPL) dynamically and to modify, 
display, and test their contents 


I/O Management, which comprises the Problem-State I/O Driver, the 
Supervisor-State I/O Driver, the Actual Block Processor, end appendages, 
an asynchronous routine, and a purge routine 


— The drivers and the Actual Block Processor translate requests for access 
to the contents of control intervals to requests for reading and writing 
physical records. They build a channel program to give to the VS2 I/O 
Supervisor. 

— The appendages and the asynchronous routine get control back to the 
requester after I/O is finished. 
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Control Block Interrelationships 


Cc Figure 47 and 48 show the VSAM control blocks built when a key-sequenced 
data set is opened. 


The role of the BIB and CMB in virtual-storage management is described in 
“‘Virtual-Storage Management” in “Diagnostic Aids.” 


- 
System Control Blocks 


User’s Record | 
Management Request : Current TCB Jobstep TCB JSCB 
GET, PUT, or POINT ! tJobstep TCB tISCB | tAMBL 
| tDEB (dummy) DEB chain chain 
User-Supplied l 
Control Blocks = a ane en SS eae ane ae aT TO LS ee 
Seer etapa " jag na I~ 

VSAM User Rl Data 
Block 
Structure 

RPLs 


Describes 


ed the VSAM Index 
Record ace | Control 
Processing | Block 
Request Describes Structure 
the VSAM | 
Data Set | 
AMBL CMB 
| 
| tindex AMB 
tRecord | 
Management 
at Load Module 
tActive | ; 
User Exit tEXLST | nee . 
i anagemen 
Routines 1DEB boa 
(dummy) Load Module 
| 
| 
l 
See EE GE OE Ee ee oe mS eet a OS ee TTS pee eS 
c Note: The data contro! block structure is shown in Figure 52. The index contro! block ét-ucture is shown in 


Figure 54. ; 
Figure 47. VSAM Control Block Structure for a Key-Sequenced Data Set (VSAM User) 
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Se ee en ere Tey Mee 
Built by Built by ISAM- { Built by VSAM Open 
' ISAM-User’s Interface Open | AMBL 
Program | +Data AMB 
® nt Data 
Control 
| Block 


Structure 


tBIB 


tRecord 
Management 
Load Module 


| 
| 
| 
| 
tDCB | 
| 
| 
| 
| 


Index 
Control 
Block 
Structure 


OF wR SE EP er Ne Pern aeRO eee Pk 


Management 
Program 


{ tISAM- tEXLST Load Module 
Interface 
Routines tDEB (dummy) 


— 4 
HICB EXLST DEB (dummy) 
‘ 
Dee 
tRPL tEODAD 
tIRNAD 
BIB 


ISAM-Interface 
Routines 


Note: The data contro! block structure is shown in Figure 52. The index control block structure is shown in 
Figure 54. 
Figure 48. VSAM Control! Block Structure for a Key-Sequenced Data Set (ISAM User) 
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ACB—Access Method Control Block 


The VSAM ACB describes a VSAM cluster. It is built by the user’s program 

with the ACB or GENCB macro. Before the cluster is opened, the ACB can 

be modified by the user’s DD statements and by the MODCB macro. After ( 
the cluster is opened, the ACB is pointed to by the RPL (RPLDACB) that 

describes the user’s record processing request. 


” 


. Access Method Control Block (ACB)—Description and Format 
Bytes and 
Offset Bi Pattern Field Name Description 
0 (0) 1 ACBID Control block identifier, X‘AO’ 
1(1) 1 ACBSTYP Subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 
2 (2) ACBLENG Length of the ACB 
4 (4) 4 ACBAMBL Address of the AMBL 
ACBIXLST Address of the index list 
ACBJWA 
ACBIBCT 
8 (8) 4 ACBINRTN Address of the VSAM Interface routine 
(IDA019R1) 
12 (C) 2 ACBMACRF MACRF flags: 
ACBMACRI MACRF flag byte 1: 
er ACBKEY The record is identified by a 
key—keyed processing 
Pa eae ACBADR The record is identified by aRBA 
ACBADD (relative byte address)—addressed 
processing { 
so lex ACBCNV Control interval processing : 
ACBBLK 
eis Msede ACBSEQ Sequential processing 
ere ere ACBDIR Direct processing 
Bra ACBIN Input (GET, READ) processing 
els ACBOUT Output (PUT, WRITE) processing 
Sdisheed 1 ACBUBF User-supplied buffer space 
13 (D) ACBMACR2 MACRF flag byte 2: 
bated ie ACBSKP Skip sequential processing 
eee Ngee ACBLOGON VTAM LOGON indicator 
wie dse ACBRST Set data set to empty state 
a ACBDSN Basic subtask shared control-block 
connection on common DSNAMEs 
Sees 1 ACBAIX Object to be processed is the alternate index 
of the path specified in the given DDNAME 
XXX. .... Reserved 
14 (E) 1 ACBBSTNO Number of concurrent strings for 
alternate-index path 
15 (F) 1 ACBSTRNO Number of RPL strings 
16 (10) 2 ACBBUFND Number of buffers requested for data 
18 (12) 2 ACBBUFNI Number of buffers requested for index 
20 (14) 4 ACBBUFPL Address of the buffer header (BUFC) 
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a 


Access Method Control Block (ACB)—Description and Format 


ACBMACR3 


ACBLSR 
ACBGSR 
ACBICI 
ACBDFR 
ACBSIS 
ACBNCFX 


ACBMACR4 
ACBJBUF 

ACBRECFM 
ACBRECAF 
ACBCCTYP 


ACBASA 
ACBOPT 


ACBCROPS 
ACBCRNCK 


ACBCRNRE 


ACBDSORG 


ACBMSGAR 
ACBPASSW 


ACBEXLST 
ACBUEL 


ACBDDNM 


ACBTIOT 
ACBINFL 
ACBAMETH 
ACBERFL 
ACBDEB 


ACBOFLGS 


ACBEOV 
ACBOPEN 
ACBDSERR 


ACBEXFG 
ACBIOSFG 


Bytes and 
Offset Bit Pattern Field Name 
20 (14) 1 
x eee 
me eer 
ws 
MesecGs x 
21 (15) | 
22 (16) 2 
24 (18) 1 
Teskees 
25 (19) 1 
.. XXXX 
26 (1A) 2 
XX.. wee. 
| Paes 
es ae 
weXX XXXX 
XXXX .XXX 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
Before OPEN 
40 (28) 8 
After OPEN 
40 (28) 2 
42 (2A) 1 
43 (2B) 1 
44 (2C) 1 
45 (2D) 3 
Not Changed by OPEN 
48 (30) 1 
ae are 
een 
eoee ues 1 
XX.. .X.. 


Description 
MACRF flag byte 3: 


Local shared resource 

Global shared resources 

Improved control-interval access 
Write operations are to be deferred 
Sequential insert strategy 

Control blocks are fixed in real storage 
Reserved 


Reserved 

Number of buffers requested for journal 
Record format: 

JES format 

Control character: 


Reserved 
Control character type 


Non-user options: 


Byte 1: 

Checkpoint/restart options: 

Restart hasn't checked for modification since 
last checkpoint 

Data added since last checkpoint hasn't been 
erased by restart, and no reposition to last 
checkpoint takes place 

Reserved 


Byte 2: 
Match with DCBDSORG 
Reserved 


Message area 
Address of the user-supplied password 
Address of the user exit list 


DD name 


Offset to the TIOT 
Indicator flags 
Access method type 
Error flags 

Address of the DEB 


Open/Close flags: 


EOV concatenation 

The ACB is open 

No further requests are possible against 
the ACB 

An ACB Exit routine exists 

The Open or Close routine is in control 
Reserved 
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Cc. 


Access Method Control Block (ACB)—Description and Format 


Bytes and 
Offset Bik Pattern 
49 (31) 1 
& $0 (32) 2 
Py ear 
pm ees 
eke: 
Pe 
X.. x 
§1 (33) 1 
§2 (34) 4 
56 (38) 4 
60 (3C) 2 
62 (3E) 2 
64 (40) 
68 (44) 
72 (48) 4 
AMB—Access Method Block 


Field Name 
ACBERFLG 


ACBINFLG 


ACBJEPS 
ACBIJRQE 
ACBCAT 
ACBSCRA 


ACBUCRA 


ACBSDS 


ACBUJFCB 
ACBBUFSP 
ACBBLKSZ 


ACBMSGLEN 


ACBLRECL 
ACBUAPTR 


ACBCBMWA 


ACBAPID 


Description 


Error flags 

Note: See ‘‘Open and Close Return Codes” 
in ‘Diagnostic Aids” for details on the 
ACBERFLG error flags. 


Indicator flags: 


JEPS processing 

RQE being held by JAM 

The ACB describes a VSAM catalog 

Catalog recovery area is built 

in system storage 

Catalog recovery area is built in user's 
storage 

A VSAM data set is being opened as a system 
data set 

Reserved 


Reserved 

Address of the user JFCB 

Amount of space available for the buffers 
Length of the physical DASD record 
Message length 

Length of the user’s record 

Address of the user’s work area 


Address of the work area for control block 
manipulation 


Address of application ID 


The AMB describes a VSAM data set or index and points to control blocks 

< needed to process data set and index records, such as the BUFC, the PLH, 
the catalog’s ACB, and the AMDSB. An AMB is built for a cluster’s data set 
and, if the cluster is key-sequenced, an AMB is built for the index. Each 
AMB associated with the cluster is pointed to by the AMBL (AMBLDTA 
points to the data AMB; AMBLIX points to the index AMB). When a data 
set’s or index’s record is being processed by VSAM record management, 
register 3 (RAMB) points to the data set’s or index’s AMB. 


Access Method Block (AMB)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
2 (2) 2 
4 (4) 4 
8 (8) 4 
12 (C) 4 
16 (10) 4 
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Field Name 
AMBID 
AMBRSC 
AMBLEN 
AMBLINK 
AMBBUFC 


AMBPH 
AMBCACB 


Description 

Control block identifier, X‘40’ 

Resource TS byte 

Length of the AMB 

Address of the next AMB in the AMB chain 


Address of the BUFC associated with the , 
AMB 


Address of the PLH associated with the AMB 


Address of the VSAM catalog’s ACB (the 
ACB of the catalog that contains the object's 
catalog record) 


EXLST—Exit List 
The EXLST contains the addresses of exit routines supplied by the user. It is 


created by the user with the EXLST or GENCB macro. The EXLST is 
Cc pointed to by the ACB (ACBEXLST). 
Exit List (EXLST)—Description and Format 
Bytes and 
Offset Bit Pattern Field Name Description 
= 0 (0) ] EXLID Control! block identifier, X°81’ 
1(1) ] EXLSTYP Subtype identifier: 
X‘10’ = VSAM 
X‘20° = VTAM 
2 (2) 2 EXLLEN Length of the control block 
4 (4) | Reserved 
5 (5) 1 EXLEODF Entry description 
6 (6) 4 EXLEODP Address of the EODAD exit routine 
10 (A) | EXLSYNF Entry description 
11 (B) 4 EXLSYNP Address of the SYNAD exit routine 
15 (F) 1 EXLLERF Entry description 
16 (10) 4 EXLLERP Address of the LERAD exit routine 
20 (14) 10 Reserved ‘ 
30 (1E) 1 EXLJRNF Entry description 
31 (1F) 4 EXLJRNP Address of the JRNAD exit routine 
35 (23) 10 Reserved 
~— HEB—Header Element Block 


The HEB is used by VSAM Virtual-Storage Management to allocate and free 
unprotected storage blocks. It contains 16 header elements, each of which 
describes a storage block. It is further described in “Virtual-Storage 
Management” in “Diagnostic Aids.” 


The HEB is pointed to by the BIB (BIBHEBPT). The first free header 
element is pointed to by BIBHEBFQ. 


Header Element Block (HEB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
HEB Block Definition 
0 (0) | HEBID Control block identifier, X*13’ 
1(1) 1 Reserved 
2 (2) 2 HEBLEN Length of the HEB (including header 
elements) 
4 (4) 4 HEBNHEB Address of the next HEB (or 0) 
8 (8) 2 Reserved 
10(A) = 2 HEBCNT Number of header elements 
12 (C) 20x16 | HEBHDELS Header elements: 
HEB Header Element Definition 
0 (0) 8 HEBFREMN Information for freeing the storage block 
Cc ge ste | described by this header element: 
0 (0) 1 HEBSP = Subpool in which the storage block is located 
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c 


Cc 


Index Create Work Area (ICWA)—Description and Format 


Offset 

42 (2A) 
44 (2C) 
46 (2E) 
48 (30) 
50 (32) 
$2 (34) 
54 (36) 
53 (37) 
56 (38) 


57 (39) 


58 (3A) 


59 (38) 


60 (3C) 
VL 
VL 


Bytes and 


Bk Pattern 


—— =a =m NY NN N N NN 


(key length) 
(key length) 
(key length) 


IICB—ISAM Interface Control Block 


The IICB is used to address the DCB (ISAM) and the ACB and RPL 
(VSAM) control blocks and associated areas needed by the ISAM interface. 


Field Name 
ICWKEY IL 
ICWKEY2L 
ICWKEY3L 
ICWNEST 
ICWNOSEG 
ICWCRSEG 
ICWREQ 
ICWPTL 
ICWCER 


ICWCEF 


ICWCEL 


ICWCERP 


ICWKEY1 
ICWKEY2 
ICWKEY3 


Description - 
Length of the current key é 
Length of the previous key 

Length of the section key 

Number of entries in the index section 

Number of segments in a spanned record 

Number of the segment being processed 

Request type 

Index entry pointer length 


Rear compression count of the current index 
entry 


Current index entry F—number of front-key 
compressed bytes 


Current index entry L—length of the 
compressed key in the entry 


Rear compression count of the previous 
index entry 


Save area for the current key 
Save area for the previous key 


Save area for the section key 


¢ 


The IICB is pointed to by the DEBWKPTS field in the ISAM DEB to provide 
integrity and by the RPLICB field in the RPL Extension to provide the 
connection to VSAM control programs. 


ISAM Interface Control Block (IICB)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 
12 (C) 
16(10) 
16 (10) 
18 (12) 
20 (14) 
24 (18) 


Bytes and 
Bit Pattern 


-_, 


=a & NN & 2S 2 AN = 


Field Name 
IICBID 


TICBLEN 
IIDCBPTR 
TIACBPTR 
IIRPLPTR 
ITW1CBF 
ISAVLRL 
NMAXLRL 
IIKEYPT 
IIFLAG!1 


IIFSCAN 
HFGET 
IIFPASS 
IIFCLOSE 
TIDATA 


Description 

Control block identifier, X‘80’ 

Reserved 

Length of IICB, in bytes 

Address of DCB 

Address of ACB 

Address of RPL 

Address of dummy scan work area 
Length of current record 

Maximum record length 

Address of key (dummy ISAM) save area 
ISAM interface status flags: ‘ 


Scan mode 

First GET request 

First pass in load mode 

Close in process 6) 
Data only retrieval 


— 


Peek A ae: eh. eg 


= 


j 
t 


ole A 


} Bs Ne 


Pe 


ISAM Interface Control Block (TICB)—Description and Format 


Bytes and 
Offset Bk Pattern 


25 (19) 3 
28 (IC) 1 
—— 
ce 
Ax 
wale 
al. 
seated 1 
29 (1D) 3 
32 (20) 2 
34 (22) 2 
36 (24) 1 
Pete te 
XXX XXXX 
37 (25) 
40 (28) 4 
44 (2C) 
45 (2D) 3 
48 (30) 4 
$2 (34) : 
60 (3C) 72 
60 (3C) 
64 (40) 
68 (44) 4 
72 (48) 60 
132 (84) 36 
132(84) 4 
132 (84) 1 
feiees 
le. 
- 
oe XK. 


Field Name 


TIFTEST 
NISEQCHK 
NQBFRS 


NACBL 


IIFLAG2 


MRKP 
MLRECL 
MBLKSI 
MOPTCD 
MRECFM 
MBUFL 
MBUFNO 
MKEYLE 


TIRPLL 


TIKEYSL 
IIBUFL 


IiFLAG3 
MBFALN 


IIMSGL 
IIMSGPTR 
IIBUFNO 


ITTBUFL 


IISVCLST 
IISAMSYN 


IIREGSAV 


MREGBC 
IIREGFC 


HAUD 
NAUDHDR 
IIAUDFLI 


AUDACBOP 
AUDACBRO 
AUDDCBEX 
AUDDCBRT 
AUDPRMOD 


s 
Description 
Loop test bit 
Resume load sequence check 


QISAM does not use buffers—no 
FREEMAIN is required 


ACB, EXLST, IICB length for 
GETMAIN/FREEMAIN 


ISAM interface status flags used by Open to 
designate the fields being merged by ISAM 
Interface. ISAM Interface Close uses the 
same mask to restore the DCB to its pre-open 
status. 


Relative key position 
Logical record length 
Block size 

Option code 

Record format 
Buffer length 

Buffer number 


Key length 


RPL and RPLE: length for 
GETMAIN/FREEMAIN 


Length of key save area, in bytes 


Length of single ISAM Interface buffer (used 
in calculations) 


ISAM interface status flags: 


BFALN merge bit 
Reserved 


Message area length 
Message area pointer 


Number of ISAM Interface buffers built by 
Open 


Total BCB and buffer length for 
GETMAIN/FREEMAIN 


SVC exit for SYNADAF 


ISAM SYNAD name—used when SYNAD is 
specified in the AMP parameter 


Register save area 
Reserved 

Previous save area pointer 
Next save area pointer 
Remainder of save area 


Audit information 


Audit flags 


OPEN was issued for ACB 

Control was returned from Open 

A DCB exit was taken 

Control was returned from the DCB exit 
A processing module was loaded: 
‘OLV'IDAIIPM1 
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ISAM Interface Control Block (IICB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
" ‘10° IDAIIPM2 é 
*11°IDAIITPM3 
Pee AUDIISYN ISAM-Interface SYNAD routine was loaded 
Games | AUDURSYN User SYNAD routine was loaded 
- 133 (85) 1 INAUDFL2 Audit flags 
| ees AUDIIFBF IDAIIFBF was loaded 
sl earaeee AUDACBCL CLOSE was issued for ACB 
a eee AUDACBRC Control was returned from Close 
nee eae AUDBFREX A flush-buffer exit was taken to IDAIIPM1 
re bee AUDBRFRT Control was returned from IDAIIPM1 
Pry ee AUDDEBXF The DEB extension was freed 
Bsus XX Reserved 
134 (86) 2 IIGMCNTR Offset from ITAUD to the next available 
entry in the audit-information fields 
136 (88) 32 NGMAUD Address of virtual-storage areas gotten 
136 (88) 4 AUDIICB Address of this IICB 
140 (8C) 4 AUDCSPLI Subpool number and length 
140 (8C) l AUDCSPI Subpool number 
141 (8D) 3 AUDCLI Length 
144 (90) 4 AUDCDEB Address of the DEB 
148 (94) 4 AUDCSPLD Subpool number and length 
148 (94) 1 AUDCSPD Subpool number 
149 (95) 3 AUDCLD Length 
152 (98) 4 AUDCBFRS Address of the area for buffers and RPLs é 
a 156(9C) 4 AUDCSPLB —_Subpool number and length . 
156 (9C) 1 AUDCSPB Subpool number 
157 (9D) 3 AUDCLB Length 
: 160 (AO) 4 AUDCMSGA Address of the physical-error message area 
164 (A4) 4 AUDCSPLM Subpool number and length 
164 (A4) 1 AUDCSPM Subpool number 
165 (A5) 3 AUDCLM Length 


IM WA—Index Insert Work Area 


The IMWA is a control block used in inserting an index entry into the index 
of a key-sequenced data set. The IMWA is created by the Open routine, and 
is pointed to by the ICWA (ICWCHN). 


Index Modification Work Area (IMW A)—Description and Format 


Bytes and 
Offset Bi Pattern Fieid Name Description 
0 (0) 1. IMWID Control Block identifier, X‘42’ 
1 (1) 1 IMWFLAGS Control flags: 
| eres IMWNEWHL Indicates a new high level should be built 
in the index structure 
ere IMWRIPL Indicates a new entry must be built in an 
index record at the next higher level to 
. reflect a new index record created by an 
é index split 
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RPL—Request Parameter List 


The RPL contains user-request information and error feedback information. 
It also contains information required by GET and PUT macros. 


The RPL is created by the user with the RPL or the GENCB macro. 
Request Parameter List (RPL)—Description and Format 


4 Offset 
0 (0) 
0 (0) 
1 (1) 


2 (2) 


3 (3) 
4(4) 
8 (8) 


9 (9) 


12 (C) 
12 (C) 


13 (D) 


13 (D) 


, x 


Bytes and 
Bk Pattern 


4 
1 
1 


Field Name 
RPLIDWD 
RPLID 
RPLSTYP 


RPLREQ 


RPLLEN 
RPLPLHPT 
RPLECB 


RPLWAIT 
RPLPOST 


RPLFDBWD 
RPLSTAT 


RPLCHKI 
RPLEDRQI 


RPLFDBK 


RPLRTNCD 
RPLERREG 


as 


Description 

Identification word of the RPL: 
Control block identifier, X‘00° 
RPL subtype: 


X‘10’ = VSAM 

X‘20° = VTAM 

Request type—when the user issues a VSAM 
macro, register 0 contains one of the 
following request-type codes; when VSAM 
processes the request, the request-type code 
in register 0 is transferred to the RPLREQ 
field (unless the request is CHECK or 
ENDREQ) 


o(0) GET request 

1(1) PUT request 

2(2) CHECK request 

3(3) POINT request 

4(4) ENDREQ request 

5(5) ERASE request 

6(6) VERIFY request 

8(8) Data preformat request 
9(9) Index preformat request 
10(A) Force I/O request 
11(B) GETIX request 

12(C) PUTIX request 

13(D) SCHBFR request 

14(E) MRKBFR request 
15(F) WRTBEFER request 
Length of the RPL 

Address of the PLH 


Address of the external ECB, or an internal 
ECB: 


The event has not yet completed 
The event has completed 
Reserved 


Reserved, if RPLECB is an internal ECB, or 
the address of the external ECB 


Feedback work: 
RPL status flags: 


CHECK has been issued 
ENDREQ has been issued 
Reserved 


RPL feedback area (See “Diagnostic Aids” 
for a list of RPL return codes and condition 
codes.) 


RPL return code 


Normal return 
Invalid control block 
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Request Parameter List (RPL)—Description and Format 


Cc ieee 


Offset Bk Pattern Field Name 
X'08" 
oc’ 
‘ 14 (E) 2 RPLCNDCD 
14 (E) i RPLCMPON 
15 (F) i RPLERRCD 
2 


16 (10) RPLKEYLE 
RPLKEYL 


RPLSTRID 
RPLCCHAR 
RPLDACB 
RPLTCBPT 


18 (12) 
20 (14) 
24 (18) 
28 (1C) 


a A A NWN 


32 (20) 4 RPLAREA 
36 (24) 4 RPLARG 
40 (28) 4 RPLOPTCD 
40 (28) 1 RPLOPT1 

| eer RPLLOC 
Peete RPLDIR 

Be eee RPLSEQ 


ee eee RPLSKP 
sace Mise RPLASY 


ee re RPLKGE 
Ie RPLGEN 
errr. 1 RPLECBSW 


41 (29) 1 RPLOPT2 


| eee RPLKEY 
x Peers RPLADR 

RPLADD 
ry Pee RPLCNV 


Pan ee RPLBWD 
ae RPLLRD 


eee RPLUPD 
Sse ats I RPLNSP 
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Description 


Logical error 
Physical error 


RPL condition code 
Component issuing the code 
Error code 

Key length 


RPL string identifier 
Address of the contro! character 
Address of the caller's ACB 


Address of the user’s TCB—this field is 
always zero for a VSAM RPL 


Address of the caller’s record area 
Address of the caller’s search argument 


Option flags 
Option flag byte 1: 


Locate mode . 
Move mode 

Direct-search access 

Sequential access 

Skip sequential processing 
Asynchronous request 
Synchronous request 

Search key greater than or equal 
Search key equal 

Generic key 

Full key 

The RPLECB field contains the 
ECB’s address 


Option flag byte 2: 


Locate the record identified by a key 
Locate the record at the caller-specified 
relative byte address (RBA) 

Locate the contro! interval at the 
caller-specified RBA 

Process in backward direction 
Locate or retrieve the last 

record in the data set 

Update processing 

Note the string position 

Reserved 


Request Parameter List (RPL)—Description and Format 


43 (2B) 
44 (2C) 


48 (30) 
$2 (34) 
56 (38) 
60 (3C) 
60 (3C) 
62 (3E) 


63 (3F) 
64 (40) 
68 (44) 
69 (45) 
70 (46) 
72 (48) 


— VN 8 Aa ab A 


- N —_ —_= PR — 


RPLE—Request Parameter List Extension 


An RPLE is built and appended to each ISAM Interface RPL when the user’s 
ISAM program opens a VSAM cluster. The RPLE contains the address of the 
IICB, a register save area, 2 linkage to other RPLs in the ISAM Interface 
RPL pool, and a pointer to the SAM DECB. 


Request Parameter List Extension (RPLE)—Description and Format 


A Offset 
0 (0) 
4 (4) 


Bytes and 
Bk Pattern 


4 
4 


Field Name 


RPLOPT3 


RPLEODS 
RPLSFORM 
RPLBLK 


RPLVFY 
RPLFLD 
RPLFMT 


RPLALIGN 


RPLOPT4 


RPLNXTRP 
RPLCHAIN 


RPLRLEN 
RPLBUFL 


RPLRBAR 
RPLAIXPC 
RPLAIXID 
RPLAXPKP 


RPLDDDD 


RPLACTIV 
RPLEMLEN 
RPLERMSA 


Field Name 
RPLIICB 
RPLDECB 


Description 
Option flag byte 3: 


End of the user’s output data set 
Spool form on remote 

Block the records 

The records are unblocked 
UCS/FCB verify 

UCS fold 

Format type: 

UCS load 

FCB load 

Reserved 

Reserved 

Align the buffer and notify the operator 
Do not align the FCB buffer loads 


Reserved 
Address of the next RPL in the chain 


Length of the record 

Length of the user's buffer 
Reserved 

RBA return location 
Alternate-index pointer count 
Alternate-index pointer type: 


Pointer is: 

0 Prime-key pointer 
1 RBA pointer 
Reserved 


Reserved 

Relative byte address 
Reserved 

CHECK not issued 
Error message length 


Address of the error message area 


Description 
Address of the ICB 


Address of the DECB—f the field contains 
zeros, the RPL has not been assigned to a 
DECB (BISAM only) 
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8 (8) 4 


12 (C) 4 


16 (10) 1 


1711) 
20 (14) 
24 (18) 


SRB—Service Request Block 


RPLIIBFR 


RPLRPLPT 


RPLITTSB 


RPLSAVE 
RPLSAVE2 


Address of the ISAM Interface buffer 

associated with the RPL (the buffer is 

required for locate mode processing, data 

only retrieval, dynamic buffering, and ; 
BISAM stand-alone write) | 


Address of the next RPL in the ISAM fe 
Interface RPL pool—if the RPL is the last 
RPL in the pool, this field contains zeros 


Test-and-set (TS) byte—this field is used to 
indicate the assignment of the RPL to a 
BISAM DECB 


Reserved 
Register save area 


Register save area 


The SRB is used by the VS2 I/O Supervisor to dispatch I/O processing for a 
request. It identifies the address space in which processing is to be done. 


The format of the SRB is given in OS/VS2 Data Areas. 


SSL—Swap Save List 


The SSL contains up to 16 entries that identify control blocks that are to be 
chained after Open has otherwise completed successfully. Deferring chaining 
makes it unnecessary to unchain the control blocks should Open fail. 


Open uses the Compare-and-Swap instruction to chain or alter storage that is 
subject to simultaneous alteration by two or more tasks. 


The SSL is pointed to by OPWA (called the ACB work area). Additional € 


SSLs are chained as required. 


Swap Save List (SSL)—Description and Format 


Bytes and 
Offset Bi Pattera 
0 (0) 1 
1 (1) 3 
4 (4) 8 
12 (C) 4 
16 (10) 2 
18 (12) 2 
20(14) 8x16 
20 (14) 4 
24 (18) 4 
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Field Name 
SSLSUBPL 
SSLLENTH 
SSLID 
SSLNXPTR 


SSLACEN 


SSLENTRY 
SSLSWPTR 


SSLSWAP 


\ Ba 
“ee 


Description 

Subpool number of the SSL 
Length of the SSL 
Identifier: ‘6IDASSLb’ 


Address of the next SSL (zero for the last 
SSL in the chain) 


Number of active entries 
Reserved 
Entries for control blocks to be chained: 


Address of the word in which SSLSWAP is to 
be placed 


The value that is to be placed at the address 
given is SSLSWPTR 


